@oh-my-pi/pi-coding-agent 14.5.12 → 14.5.14

package/src/web/scrapers/discourse.ts

@@ -77,12 +77,12 @@ function formatCategory(topic: DiscourseTopic): string | null {
 	return parts.length ? parts.join(" ") : null;
 }
 
-function formatPostBody(post: DiscoursePost): string {
+async function formatPostBody(post: DiscoursePost): Promise<string> {
 	const raw = post.raw?.trim();
 	if (raw) return raw;
 	const cooked = post.cooked?.trim();
 	if (!cooked) return "";
-	return htmlToBasicMarkdown(cooked);
+	return await htmlToBasicMarkdown(cooked);
 }
 
 function buildTopicUrl(baseUrl: string, topicId: string): string {
@@ -168,9 +168,9 @@ export const handleDiscourse: SpecialHandler = async (
 		md += "\n";
 
 		const description = topic.excerpt
-			? htmlToBasicMarkdown(topic.excerpt)
+			? await htmlToBasicMarkdown(topic.excerpt)
 			: posts.length
-				? formatPostBody(posts[0])
+				? await formatPostBody(posts[0])
 				: "";
 		if (description) {
 			md += `## Description\n\n${description}\n\n`;
@@ -182,7 +182,7 @@ export const handleDiscourse: SpecialHandler = async (
 				const author = formatAuthor({ name: post.name, username: post.username });
 				const date = formatIsoDate(post.created_at);
 				const likes = post.like_count ?? 0;
-				const content = formatPostBody(post);
+				const content = await formatPostBody(post);
 				const postLabel = post.post_number != null ? `Post ${post.post_number}` : `Post ${post.id}`;
 
 				md += `### ${postLabel} - ${author} - ${date} - Likes: ${likes}\n\n`;

package/src/web/scrapers/firefox-addons.ts

@@ -112,7 +112,7 @@ export const handleFirefoxAddons: SpecialHandler = async (
 		const name = getLocalizedText(data.name, defaultLocale) ?? slug;
 		const summary = getLocalizedText(data.summary, defaultLocale);
 		const descriptionRaw = getLocalizedText(data.description, defaultLocale);
-		const description = descriptionRaw ? htmlToBasicMarkdown(descriptionRaw) : undefined;
+		const description = descriptionRaw ? await htmlToBasicMarkdown(descriptionRaw) : undefined;
 
 		const authors = (data.authors ?? [])
 			.map(author => author.name ?? "")

package/src/web/scrapers/flathub.ts

@@ -170,7 +170,7 @@ export const handleFlathub: SpecialHandler = async (
 		}
 
 		if (app.description) {
-			const description = htmlToBasicMarkdown(app.description);
+			const description = await htmlToBasicMarkdown(app.description);
 			if (description) md += `\n## Description\n\n${description}\n`;
 		}
 
@@ -204,7 +204,7 @@ export const handleFlathub: SpecialHandler = async (
 				md += `${line}\n`;
 
 				if (release.description) {
-					const releaseDesc = htmlToBasicMarkdown(release.description).replace(/\n+/g, " ").trim();
+					const releaseDesc = (await htmlToBasicMarkdown(release.description)).replace(/\n+/g, " ").trim();
 					if (releaseDesc) md += `  - ${releaseDesc}\n`;
 				}
 			}

package/src/web/scrapers/gitlab.ts

@@ -259,7 +259,7 @@ async function renderGitLabIssue(
 	}
 
 	md += `\n---\n\n## Description\n\n`;
-	md += issue.description ? htmlToBasicMarkdown(issue.description) : "*No description*";
+	md += issue.description ? await htmlToBasicMarkdown(issue.description) : "*No description*";
 
 	return { content: md, ok: true };
 }

package/src/web/scrapers/go-pkg.ts

@@ -159,7 +159,7 @@ export const handleGoPkg: SpecialHandler = async (
 			// Get overview paragraph
 			const overview = docSection.querySelector(".go-Message");
 			if (overview) {
-				const overviewMd = htmlToBasicMarkdown(overview.innerHTML);
+				const overviewMd = await htmlToBasicMarkdown(overview.innerHTML);
 				sections.push(overviewMd);
 				sections.push("");
 			}
@@ -172,7 +172,7 @@ export const handleGoPkg: SpecialHandler = async (
 				const docParts: string[] = [];
 				for (let i = 0; i < Math.min(3, paragraphs.length); i++) {
 					const p = paragraphs[i];
-					const text = htmlToBasicMarkdown(p.innerHTML).trim();
+					const text = (await htmlToBasicMarkdown(p.innerHTML)).trim();
 					if (text) {
 						docParts.push(text);
 					}

package/src/web/scrapers/jetbrains-marketplace.ts

@@ -108,7 +108,7 @@ export const handleJetBrainsMarketplace: SpecialHandler = async (
 
 		const vendorName = plugin.vendor?.name ?? plugin.vendor?.publicName;
 		const descriptionSource = plugin.description ?? plugin.preview ?? "";
-		const description = descriptionSource ? htmlToBasicMarkdown(descriptionSource) : "";
+		const description = descriptionSource ? await htmlToBasicMarkdown(descriptionSource) : "";
 		const tags = (plugin.tags ?? []).map(tag => tag.name).filter(Boolean) as string[];
 		const rating = extractRating(plugin);
 		const buildCompatibility = update ? formatBuildCompatibility(update) : null;

package/src/web/scrapers/mastodon.ts

@@ -89,11 +89,11 @@ function formatDate(isoDate: string): string {
 /**
  * Format a status/post as markdown
  */
-function formatStatus(status: MastodonStatus, isReblog = false): string {
+async function formatStatus(status: MastodonStatus, isReblog = false): Promise<string> {
 	// Handle reblogs (boosts)
 	if (status.reblog && !isReblog) {
 		let md = `🔁 **${status.account.display_name || status.account.username}** boosted:\n\n`;
-		md += formatStatus(status.reblog, true);
+		md += await formatStatus(status.reblog, true);
 		return md;
 	}
 
@@ -116,7 +116,7 @@ function formatStatus(status: MastodonStatus, isReblog = false): string {
 	}
 
 	// Main content (convert HTML to markdown)
-	const content = htmlToBasicMarkdown(status.content);
+	const content = await htmlToBasicMarkdown(status.content);
 	md += `${content}\n\n`;
 
 	// Poll
@@ -152,7 +152,7 @@ function formatStatus(status: MastodonStatus, isReblog = false): string {
 /**
  * Format an account/profile as markdown
  */
-function formatAccount(account: MastodonAccount): string {
+async function formatAccount(account: MastodonAccount): Promise<string> {
 	let md = `# ${account.display_name || account.username}\n\n`;
 
 	md += `**@${account.acct}**`;
@@ -161,7 +161,7 @@ function formatAccount(account: MastodonAccount): string {
 
 	// Bio
 	if (account.note) {
-		const bio = htmlToBasicMarkdown(account.note);
+		const bio = await htmlToBasicMarkdown(account.note);
 		if (bio && bio !== account.display_name) {
 			md += `${bio}\n\n`;
 		}
@@ -179,7 +179,7 @@ function formatAccount(account: MastodonAccount): string {
 	if (account.fields && account.fields.length > 0) {
 		md += "\n**Profile Fields:**\n";
 		for (const field of account.fields) {
-			const value = htmlToBasicMarkdown(field.value);
+			const value = await htmlToBasicMarkdown(field.value);
 			md += `- **${field.name}:** ${value}\n`;
 		}
 	}
@@ -228,7 +228,7 @@ export const handleMastodon: SpecialHandler = async (
 			const status = tryParseJson<MastodonStatus>(result.content);
 			if (!status) return null;
 
-			const md = formatStatus(status);
+			const md = await formatStatus(status);
 
 			return buildResult(md, {
 				url,
@@ -263,7 +263,7 @@ export const handleMastodon: SpecialHandler = async (
 				signal,
 			});
 
-			let md = formatAccount(account);
+			let md = await formatAccount(account);
 
 			if (statusesResult.ok) {
 				const statuses = tryParseJson<MastodonStatus[]>(statusesResult.content);
@@ -271,7 +271,7 @@ export const handleMastodon: SpecialHandler = async (
 					md += "\n---\n\n## Recent Posts\n\n";
 					for (const status of statuses.slice(0, 5)) {
 						md += `### ${formatDate(status.created_at)}\n\n`;
-						const content = htmlToBasicMarkdown(status.content);
+						const content = await htmlToBasicMarkdown(status.content);
 						md += `${content}\n\n`;
 						md += `\uD83D\uDCAC ${status.replies_count} \u00B7 \uD83D\uDD01 ${status.reblogs_count} \u00B7 \u2B50 ${status.favourites_count}\n\n`;
 					}

package/src/web/scrapers/mdn.ts

@@ -29,7 +29,7 @@ interface MDNDoc {
 /**
  * Convert MDN body sections to markdown
  */
-function convertMDNBody(sections: MDNSection[]): string {
+async function convertMDNBody(sections: MDNSection[]): Promise<string> {
 	const parts: string[] = [];
 
 	for (const section of sections) {
@@ -38,7 +38,7 @@ function convertMDNBody(sections: MDNSection[]): string {
 		switch (type) {
 			case "prose":
 				if (value.content) {
-					const markdown = htmlToBasicMarkdown(value.content);
+					const markdown = await htmlToBasicMarkdown(value.content);
 					if (value.title) {
 						const level = value.isH3 ? "###" : "##";
 						parts.push(`${level} ${value.title}\n\n${markdown}`);
@@ -74,7 +74,7 @@ function convertMDNBody(sections: MDNSection[]): string {
 				if (value.items) {
 					for (const item of value.items) {
 						parts.push(`**${item.term}**`);
-						const desc = htmlToBasicMarkdown(item.description);
+						const desc = await htmlToBasicMarkdown(item.description);
 						parts.push(desc);
 					}
 				}
@@ -83,9 +83,13 @@ function convertMDNBody(sections: MDNSection[]): string {
 			case "table":
 				if (value.rows && value.rows.length > 0) {
 					// Simple markdown table
-					const header = value.rows[0].map(cell => htmlToBasicMarkdown(cell)).join(" | ");
+					const header = (await Promise.all(value.rows[0].map(cell => htmlToBasicMarkdown(cell)))).join(" | ");
 					const separator = value.rows[0].map(() => "---").join(" | ");
-					const bodyRows = value.rows.slice(1).map(row => row.map(cell => htmlToBasicMarkdown(cell)).join(" | "));
+					const bodyRows = await Promise.all(
+						value.rows
+							.slice(1)
+							.map(async row => (await Promise.all(row.map(cell => htmlToBasicMarkdown(cell)))).join(" | ")),
+					);
 
 					parts.push(`| ${header} |`);
 					parts.push(`| ${separator} |`);
@@ -144,12 +148,12 @@ export const handleMDN: SpecialHandler = async (url: string, timeout: number, si
 		parts.push(`# ${doc.title}`);
 
 		if (doc.summary) {
-			const summary = htmlToBasicMarkdown(doc.summary);
+			const summary = await htmlToBasicMarkdown(doc.summary);
 			parts.push(summary);
 		}
 
 		if (doc.body && doc.body.length > 0) {
-			const bodyMarkdown = convertMDNBody(doc.body);
+			const bodyMarkdown = await convertMDNBody(doc.body);
 			parts.push(bodyMarkdown);
 		}
 

package/src/web/scrapers/pub-dev.ts

@@ -125,7 +125,7 @@ export const handlePubDev: SpecialHandler = async (url: string, timeout: number,
 					/<div[^>]*class="[^"]*markdown-body[^"]*"[^>]*>([\s\S]*?)<\/div>/i,
 				);
 				if (readmeMatch) {
-					const readme = htmlToBasicMarkdown(readmeMatch[1]);
+					const readme = await htmlToBasicMarkdown(readmeMatch[1]);
 
 					if (readme.length > 100) {
 						md += `## README\n\n${readme}\n`;

package/src/web/scrapers/rawg.ts

@@ -63,7 +63,7 @@ export const handleRawg: SpecialHandler = async (
 		md += `**RAWG:** https://rawg.io/games/${encodeURIComponent(slug)}\n`;
 		md += "\n";
 
-		const description = extractDescription(game);
+		const description = await extractDescription(game);
 		if (description) {
 			md += `## Description\n\n${description}\n`;
 		}
@@ -91,11 +91,11 @@ function requiresApiKey(game: RawgGameResponse): boolean {
 	return detail.includes("api key") || detail.includes("key is required") || detail.includes("apikey");
 }
 
-function extractDescription(game: RawgGameResponse): string | null {
+async function extractDescription(game: RawgGameResponse): Promise<string | null> {
 	if (game.description_raw) return game.description_raw.trim();
 	if (!game.description) return null;
 
-	const markdown = htmlToBasicMarkdown(game.description).trim();
+	const markdown = (await htmlToBasicMarkdown(game.description)).trim();
 	return markdown || null;
 }
 

package/src/web/scrapers/readthedocs.ts

@@ -101,7 +101,7 @@ export const handleReadTheDocs: SpecialHandler = async (
 	// If no raw source, convert HTML to markdown
 	if (!content && mainContent) {
 		const html = mainContent.innerHTML;
-		content = htmlToBasicMarkdown(html);
+		content = await htmlToBasicMarkdown(html);
 	}
 
 	if (!content) {

package/src/web/scrapers/spdx.ts

@@ -94,7 +94,7 @@ export const handleSpdx: SpecialHandler = async (
 		const licenseText = license.licenseText
 			? license.licenseText
 			: license.licenseTextHtml
-				? htmlToBasicMarkdown(license.licenseTextHtml)
+				? await htmlToBasicMarkdown(license.licenseTextHtml)
 				: null;
 
 		if (licenseText) {

package/src/web/scrapers/stackoverflow.ts

@@ -90,7 +90,7 @@ export const handleStackOverflow: SpecialHandler = async (
 		md += question.is_answered ? " (Answered)" : "";
 		md += `\n**Tags:** ${question.tags.join(", ")}\n`;
 		md += `**Asked by:** ${question.owner.display_name} · ${formatIsoDate(question.creation_date * 1000)}\n\n`;
-		md += `---\n\n## Question\n\n${htmlToBasicMarkdown(question.body)}\n\n`;
+		md += `---\n\n## Question\n\n${await htmlToBasicMarkdown(question.body)}\n\n`;
 
 		// Fetch answers
 		const aUrl = `https://api.stackexchange.com/2.3/questions/${questionId}/answers?order=desc&sort=votes&site=${site}&filter=withbody`;
@@ -103,7 +103,7 @@ export const handleStackOverflow: SpecialHandler = async (
 				for (const answer of aData.items.slice(0, 5)) {
 					const accepted = answer.is_accepted ? " (Accepted)" : "";
 					md += `### Score: ${answer.score}${accepted} · by ${answer.owner.display_name}\n\n`;
-					md += `${htmlToBasicMarkdown(answer.body)}\n\n---\n\n`;
+					md += `${await htmlToBasicMarkdown(answer.body)}\n\n---\n\n`;
 				}
 			}
 		}

package/src/web/scrapers/types.ts

@@ -2,8 +2,8 @@
  * Shared types and utilities for web-fetch handlers
  */
 import { ptree } from "@oh-my-pi/pi-utils";
-import TurndownService from "turndown";
-import { gfm } from "turndown-plugin-gfm";
+import type TurndownService from "turndown";
+
 import { ToolAbortError } from "../../tools/tool-errors";
 
 export { formatNumber } from "@oh-my-pi/pi-utils";
@@ -155,28 +155,8 @@ export async function loadPage(url: string, options: LoadPageOptions = {}): Prom
 	return { content: "", contentType: "", finalUrl: url, ok: false };
 }
 
-/** Module-level Turndown instance — matches markit-ai's configuration. */
-const turndown = new TurndownService({
-	headingStyle: "atx",
-	codeBlockStyle: "fenced",
-	bulletListMarker: "-",
-});
-turndown.use(gfm);
-turndown.addRule("strikethrough", {
-	filter: ["del", "s", "strike"],
-	replacement(content) {
-		return `~~${content}~~`;
-	},
-});
-turndown.addRule("heading", {
-	filter: ["h1", "h2", "h3", "h4", "h5", "h6"],
-	replacement(content, node) {
-		const level = Number(node.nodeName.charAt(1));
-		const prefix = "#".repeat(level);
-		const cleaned = content.replace(/\\([.])/g, "$1").trim();
-		return `\n\n${prefix} ${cleaned}\n\n`;
-	},
-});
+/** Module-level Turndown instance — built lazily on first use. */
+let turndownPromise: Promise<TurndownService> | undefined;
 
 type TurndownListParent = {
 	nodeName: string;
@@ -184,27 +164,61 @@ type TurndownListParent = {
 	children: ArrayLike<unknown>;
 };
 
-turndown.addRule("listItem", {
-	filter: "li",
-	replacement(content, node, options) {
-		content = content.replace(/^\n+/, "").replace(/\n+$/, "\n").replace(/\n/gm, "\n  ");
-		const parent = node.parentNode as unknown as TurndownListParent | null;
-		let prefix = `${options.bulletListMarker} `;
-		if (parent?.nodeName === "OL") {
-			const start = parent.getAttribute("start");
-			const index = Array.prototype.indexOf.call(parent.children, node);
-			prefix = `${(start ? Number(start) : 1) + index}. `;
-		}
-		return prefix + content + (node.nextSibling ? "\n" : "");
-	},
-});
+function getTurndown(): Promise<TurndownService> {
+	turndownPromise ||= initTurndown();
+	return turndownPromise;
+}
+
+async function initTurndown(): Promise<TurndownService> {
+	const [{ default: TurndownService }, { gfm }] = await Promise.all([
+		import("turndown"),
+		import("turndown-plugin-gfm"),
+	]);
+	const turndown = new TurndownService({
+		headingStyle: "atx",
+		codeBlockStyle: "fenced",
+		bulletListMarker: "-",
+	});
+	turndown.use(gfm);
+	turndown.addRule("strikethrough", {
+		filter: ["del", "s", "strike"],
+		replacement(content) {
+			return `~~${content}~~`;
+		},
+	});
+	turndown.addRule("heading", {
+		filter: ["h1", "h2", "h3", "h4", "h5", "h6"],
+		replacement(content, node) {
+			const level = Number(node.nodeName.charAt(1));
+			const prefix = "#".repeat(level);
+			const cleaned = content.replace(/\\([.])/g, "$1").trim();
+			return `\n\n${prefix} ${cleaned}\n\n`;
+		},
+	});
+	turndown.addRule("listItem", {
+		filter: "li",
+		replacement(content, node, options) {
+			content = content.replace(/^\n+/, "").replace(/\n+$/, "\n").replace(/\n/gm, "\n  ");
+			const parent = node.parentNode as unknown as TurndownListParent | null;
+			let prefix = `${options.bulletListMarker} `;
+			if (parent?.nodeName === "OL") {
+				const start = parent.getAttribute("start");
+				const index = Array.prototype.indexOf.call(parent.children, node);
+				prefix = `${(start ? Number(start) : 1) + index}. `;
+			}
+			return prefix + content + (node.nextSibling ? "\n" : "");
+		},
+	});
+	return turndown;
+}
 
 /**
  * Convert HTML to markdown using Turndown with GFM support.
  * Strips script/style tags before conversion.
  */
-export function htmlToBasicMarkdown(html: string): string {
+export async function htmlToBasicMarkdown(html: string): Promise<string> {
 	const cleaned = html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "");
+	const turndown = await getTurndown();
 	return turndown.turndown(cleaned).trim();
 }
 

package/src/web/scrapers/w3c.ts

@@ -100,7 +100,7 @@ export const handleW3c: SpecialHandler = async (
 		const title = getString(specPayload, "title");
 		const shortnameValue = getString(specPayload, "shortname") ?? shortname;
 		const description = getString(specPayload, "description") ?? getString(specPayload, "abstract");
-		const abstract = description ? htmlToBasicMarkdown(description) : undefined;
+		const abstract = description ? await htmlToBasicMarkdown(description) : undefined;
 
 		const latestVersionUrl =
 			getString(latestPayload, "uri") ??

package/src/web/search/index.ts

@@ -15,7 +15,7 @@ import webSearchSystemPrompt from "../../prompts/system/web-search.md" with { ty
 import webSearchDescription from "../../prompts/tools/web-search.md" with { type: "text" };
 import type { ToolSession } from "../../tools";
 import { formatAge } from "../../tools/render-utils";
-import { getSearchProvider, resolveProviderChain, type SearchProvider } from "./provider";
+import { getSearchProvider, getSearchProviderLabel, resolveProviderChain, type SearchProvider } from "./provider";
 import { renderSearchCall, renderSearchResult, type SearchRenderDetails } from "./render";
 import type { SearchProviderId, SearchResponse } from "./types";
 import { SearchProviderError } from "./types";
@@ -63,7 +63,7 @@ function formatProviderError(error: unknown, provider: SearchProvider): string {
 			if (error.provider === "zai") {
 				return error.message;
 			}
-			return `${getSearchProvider(error.provider).label} authorization failed (${error.status}). Check API key or base URL.`;
+			return `${getSearchProviderLabel(error.provider)} authorization failed (${error.status}). Check API key or base URL.`;
 		}
 		return error.message;
 	}
@@ -139,9 +139,9 @@ async function executeSearch(
 ): Promise<{ content: Array<{ type: "text"; text: string }>; details: SearchRenderDetails }> {
 	const providers =
 		params.provider && params.provider !== "auto"
-			? (await getSearchProvider(params.provider).isAvailable())
-				? [getSearchProvider(params.provider)]
-				: await resolveProviderChain("auto")
+			? await getSearchProvider(params.provider).then(provider =>
+					provider.isAvailable() ? [provider] : resolveProviderChain("auto"),
+				)
 			: await resolveProviderChain();
 	if (providers.length === 0) {
 		const message = "No web search provider configured.";

package/src/web/search/provider.ts

@@ -1,39 +1,121 @@
-import { AnthropicProvider } from "./providers/anthropic";
+// Lazy registry of web search providers.
+//
+// Each provider is loaded on first use; importing this module loads zero
+// provider implementations. Provider modules are heavy (each pulls in
+// fetch/parse/format helpers) and only one — at most — is needed per session,
+// so eager construction was wasted work at startup.
+//
+// The `label`/`id` metadata is kept inline so callers needing a display name
+// (error formatting, UI listings) do not force a load.
+
 import type { SearchProvider } from "./providers/base";
-import { BraveProvider } from "./providers/brave";
-import { CodexProvider } from "./providers/codex";
-import { ExaProvider } from "./providers/exa";
-import { GeminiProvider } from "./providers/gemini";
-import { JinaProvider } from "./providers/jina";
-import { KagiProvider } from "./providers/kagi";
-import { KimiProvider } from "./providers/kimi";
-import { ParallelProvider } from "./providers/parallel";
-import { PerplexityProvider } from "./providers/perplexity";
-import { SearXNGProvider } from "./providers/searxng";
-import { SyntheticProvider } from "./providers/synthetic";
-import { TavilyProvider } from "./providers/tavily";
-import { ZaiProvider } from "./providers/zai";
 import type { SearchProviderId } from "./types";
 
 export type { SearchParams } from "./providers/base";
 export { SearchProvider } from "./providers/base";
 
-const SEARCH_PROVIDERS: Record<SearchProviderId, SearchProvider> = {
-	exa: new ExaProvider(),
-	brave: new BraveProvider(),
-	jina: new JinaProvider(),
-	perplexity: new PerplexityProvider(),
-	kimi: new KimiProvider(),
-	zai: new ZaiProvider(),
-	anthropic: new AnthropicProvider(),
-	gemini: new GeminiProvider(),
-	codex: new CodexProvider(),
-	tavily: new TavilyProvider(),
-	parallel: new ParallelProvider(),
-	kagi: new KagiProvider(),
-	synthetic: new SyntheticProvider(),
-	searxng: new SearXNGProvider(),
-} as const;
+interface ProviderMeta {
+	id: SearchProviderId;
+	label: string;
+	load: () => Promise<SearchProvider>;
+}
+
+/** Lazy factories. Each `load()` dynamic-imports its provider module on first call. */
+const PROVIDER_META: Record<SearchProviderId, ProviderMeta> = {
+	exa: {
+		id: "exa",
+		label: "Exa",
+		load: async () => new (await import("./providers/exa")).ExaProvider(),
+	},
+	brave: {
+		id: "brave",
+		label: "Brave",
+		load: async () => new (await import("./providers/brave")).BraveProvider(),
+	},
+	jina: {
+		id: "jina",
+		label: "Jina",
+		load: async () => new (await import("./providers/jina")).JinaProvider(),
+	},
+	perplexity: {
+		id: "perplexity",
+		label: "Perplexity",
+		load: async () => new (await import("./providers/perplexity")).PerplexityProvider(),
+	},
+	kimi: {
+		id: "kimi",
+		label: "Kimi",
+		load: async () => new (await import("./providers/kimi")).KimiProvider(),
+	},
+	zai: {
+		id: "zai",
+		label: "Z.AI",
+		load: async () => new (await import("./providers/zai")).ZaiProvider(),
+	},
+	anthropic: {
+		id: "anthropic",
+		label: "Anthropic",
+		load: async () => new (await import("./providers/anthropic")).AnthropicProvider(),
+	},
+	gemini: {
+		id: "gemini",
+		label: "Gemini",
+		load: async () => new (await import("./providers/gemini")).GeminiProvider(),
+	},
+	codex: {
+		id: "codex",
+		label: "Codex",
+		load: async () => new (await import("./providers/codex")).CodexProvider(),
+	},
+	tavily: {
+		id: "tavily",
+		label: "Tavily",
+		load: async () => new (await import("./providers/tavily")).TavilyProvider(),
+	},
+	parallel: {
+		id: "parallel",
+		label: "Parallel",
+		load: async () => new (await import("./providers/parallel")).ParallelProvider(),
+	},
+	kagi: {
+		id: "kagi",
+		label: "Kagi",
+		load: async () => new (await import("./providers/kagi")).KagiProvider(),
+	},
+	synthetic: {
+		id: "synthetic",
+		label: "Synthetic",
+		load: async () => new (await import("./providers/synthetic")).SyntheticProvider(),
+	},
+	searxng: {
+		id: "searxng",
+		label: "SearXNG",
+		load: async () => new (await import("./providers/searxng")).SearXNGProvider(),
+	},
+};
+
+const instanceCache = new Map<SearchProviderId, SearchProvider>();
+
+/** Cheap, sync metadata accessor — never triggers a provider load. */
+export function getSearchProviderLabel(id: SearchProviderId): string {
+	return PROVIDER_META[id]?.label ?? id;
+}
+
+/**
+ * Resolve and cache a provider instance. First call for a given id loads the
+ * underlying module; subsequent calls return the cached singleton.
+ */
+export async function getSearchProvider(id: SearchProviderId): Promise<SearchProvider> {
+	const cached = instanceCache.get(id);
+	if (cached) return cached;
+	const meta = PROVIDER_META[id];
+	if (!meta) {
+		throw new Error(`Unknown search provider: ${id}`);
+	}
+	const provider = await meta.load();
+	instanceCache.set(id, provider);
+	return provider;
+}
 
 export const SEARCH_PROVIDER_ORDER: SearchProviderId[] = [
 	"tavily",
@@ -52,10 +134,6 @@ export const SEARCH_PROVIDER_ORDER: SearchProviderId[] = [
 	"searxng",
 ];
 
-export function getSearchProvider(provider: SearchProviderId): SearchProvider {
-	return SEARCH_PROVIDERS[provider];
-}
-
 /** Preferred provider set via settings (default: auto) */
 let preferredProvId: SearchProviderId | "auto" = "auto";
 
@@ -64,22 +142,26 @@ export function setPreferredSearchProvider(provider: SearchProviderId | "auto"):
 	preferredProvId = provider;
 }
 
-/** Determine which providers are configured  */
+/**
+ * Determine which providers are configured and currently available.
+ * Each candidate is loaded (and its `isAvailable()` called) only as the chain
+ * is walked, so unconfigured providers never pay the load cost.
+ */
 export async function resolveProviderChain(
 	preferredProvider: SearchProviderId | "auto" = preferredProvId,
 ): Promise<SearchProvider[]> {
 	const providers: SearchProvider[] = [];
 
 	if (preferredProvider !== "auto") {
-		if (await getSearchProvider(preferredProvider).isAvailable()) {
-			providers.push(getSearchProvider(preferredProvider));
+		const provider = await getSearchProvider(preferredProvider);
+		if (await provider.isAvailable()) {
+			providers.push(provider);
 		}
 	}
 
 	for (const id of SEARCH_PROVIDER_ORDER) {
 		if (id === preferredProvider) continue;
-
-		const provider = getSearchProvider(id);
+		const provider = await getSearchProvider(id);
 		if (await provider.isAvailable()) {
 			providers.push(provider);
 		}