@oh-my-pi/pi-coding-agent 3.30.0 → 3.31.0

package/src/core/tools/{web-fetch-handlers → web-scrapers}/artifacthub.ts

@@ -53,7 +53,11 @@ interface ArtifactHubPackage {
  * Handle Artifact Hub URLs via API
  * Supports Helm charts, OLM operators, Falco rules, OPA policies, etc.
  */
-export const handleArtifactHub: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleArtifactHub: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		if (parsed.hostname !== "artifacthub.io" && parsed.hostname !== "www.artifacthub.io") return null;
@@ -70,6 +74,7 @@ export const handleArtifactHub: SpecialHandler = async (url: string, timeout: nu
 		const result = await loadPage(apiUrl, {
 			timeout,
 			headers: { Accept: "application/json" },
+			signal,
 		});
 
 		if (!result.ok) return null;

package/src/core/tools/{web-fetch-handlers → web-scrapers}/arxiv.ts

@@ -6,7 +6,11 @@ import { convertWithMarkitdown, fetchBinary } from "./utils";
 /**
  * Handle arXiv URLs via arXiv API
  */
-export const handleArxiv: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleArxiv: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		if (parsed.hostname !== "arxiv.org") return null;
@@ -22,7 +26,7 @@ export const handleArxiv: SpecialHandler = async (url: string, timeout: number):
 
 		// Fetch metadata via arXiv API
 		const apiUrl = `https://export.arxiv.org/api/query?id_list=${paperId}`;
-		const result = await loadPage(apiUrl, { timeout });
+		const result = await loadPage(apiUrl, { timeout, signal });
 
 		if (!result.ok) return null;
 
@@ -56,9 +60,9 @@ export const handleArxiv: SpecialHandler = async (url: string, timeout: number):
 		if (match[1] === "pdf" || parsed.pathname.includes(".pdf")) {
 			if (pdfLink) {
 				notes.push("Fetching PDF for full content...");
-				const pdfResult = await fetchBinary(pdfLink, timeout);
+				const pdfResult = await fetchBinary(pdfLink, timeout, signal);
 				if (pdfResult.ok) {
-					const converted = await convertWithMarkitdown(pdfResult.buffer, ".pdf", timeout);
+					const converted = await convertWithMarkitdown(pdfResult.buffer, ".pdf", timeout, signal);
 					if (converted.ok && converted.content.length > 500) {
 						md += `---\n\n## Full Paper\n\n${converted.content}\n`;
 						notes.push("PDF converted via markitdown");

package/src/core/tools/{web-fetch-handlers → web-scrapers}/aur.ts

@@ -35,7 +35,11 @@ interface AurResponse {
 /**
  * Handle AUR (Arch User Repository) URLs via RPC API
  */
-export const handleAur: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleAur: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		if (parsed.hostname !== "aur.archlinux.org") return null;
@@ -49,7 +53,7 @@ export const handleAur: SpecialHandler = async (url: string, timeout: number): P
 
 		// Fetch from AUR RPC API
 		const apiUrl = `https://aur.archlinux.org/rpc/?v=5&type=info&arg=${encodeURIComponent(packageName)}`;
-		const result = await loadPage(apiUrl, { timeout });
+		const result = await loadPage(apiUrl, { timeout, signal });
 
 		if (!result.ok) return null;
 

package/src/core/tools/{web-fetch-handlers → web-scrapers}/biorxiv.ts

@@ -27,7 +27,11 @@ interface BiorxivResponse {
 /**
  * Handle bioRxiv and medRxiv preprint URLs via their API
  */
-export const handleBiorxiv: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleBiorxiv: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		const hostname = parsed.hostname.toLowerCase();
@@ -54,6 +58,7 @@ export const handleBiorxiv: SpecialHandler = async (url: string, timeout: number
 		const result = await loadPage(apiUrl, {
 			timeout,
 			headers: { Accept: "application/json" },
+			signal,
 		});
 
 		if (!result.ok) return null;

package/src/core/tools/{web-fetch-handlers → web-scrapers}/bluesky.ts

@@ -54,11 +54,12 @@ interface ThreadViewPost {
 /**
  * Resolve a handle to DID using the profile API
  */
-async function resolveHandle(handle: string, timeout: number): Promise<string | null> {
+async function resolveHandle(handle: string, timeout: number, signal?: AbortSignal): Promise<string | null> {
 	const url = `${API_BASE}/app.bsky.actor.getProfile?actor=${encodeURIComponent(handle)}`;
 	const result = await loadPage(url, {
 		timeout,
 		headers: { Accept: "application/json" },
+		signal,
 	});
 
 	if (!result.ok) return null;
@@ -148,7 +149,11 @@ function formatPost(post: BlueskyPost, isQuote = false): string {
 /**
  * Handle Bluesky post URLs
  */
-export const handleBluesky: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleBluesky: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		if (!["bsky.app", "www.bsky.app"].includes(parsed.hostname)) {
@@ -167,7 +172,7 @@ export const handleBluesky: SpecialHandler = async (url: string, timeout: number
 				const rkey = pathParts[3];
 
 				// First resolve handle to DID
-				const did = await resolveHandle(handle, timeout);
+				const did = await resolveHandle(handle, timeout, signal);
 				if (!did) return null;
 
 				// Construct AT URI and fetch thread
@@ -177,6 +182,7 @@ export const handleBluesky: SpecialHandler = async (url: string, timeout: number
 				const result = await loadPage(threadUrl, {
 					timeout,
 					headers: { Accept: "application/json" },
+					signal,
 				});
 
 				if (!result.ok) return null;
@@ -230,6 +236,7 @@ export const handleBluesky: SpecialHandler = async (url: string, timeout: number
 			const result = await loadPage(profileUrl, {
 				timeout,
 				headers: { Accept: "application/json" },
+				signal,
 			});
 
 			if (!result.ok) return null;

package/src/core/tools/{web-fetch-handlers → web-scrapers}/brew.ts

@@ -58,7 +58,11 @@ function getInstallCount(analytics?: { install?: { "30d"?: Record<string, number
 /**
  * Handle Homebrew formulae and cask URLs via API
  */
-export const handleBrew: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleBrew: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		if (parsed.hostname !== "formulae.brew.sh") return null;
@@ -76,7 +80,7 @@ export const handleBrew: SpecialHandler = async (url: string, timeout: number):
 			? `https://formulae.brew.sh/api/formula/${encodeURIComponent(name)}.json`
 			: `https://formulae.brew.sh/api/cask/${encodeURIComponent(name)}.json`;
 
-		const result = await loadPage(apiUrl, { timeout });
+		const result = await loadPage(apiUrl, { timeout, signal });
 		if (!result.ok) return null;
 
 		let md: string;

package/src/core/tools/{web-fetch-handlers → web-scrapers}/cheatsh.ts

@@ -7,7 +7,11 @@ import { finalizeOutput, loadPage } from "./types";
  * API: Plain text at https://cheat.sh/{topic}?T (T flag removes ANSI colors)
  * Supports: commands, language/topic queries (e.g., python/list, go/slice)
  */
-export const handleCheatSh: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleCheatSh: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		if (parsed.hostname !== "cheat.sh" && parsed.hostname !== "cht.sh") return null;
@@ -22,6 +26,7 @@ export const handleCheatSh: SpecialHandler = async (url: string, timeout: number
 		const apiUrl = `https://cheat.sh/${encodeURIComponent(topic)}?T`;
 		const result = await loadPage(apiUrl, {
 			timeout,
+			signal,
 			headers: {
 				Accept: "text/plain",
 			},

package/src/core/tools/{web-fetch-handlers → web-scrapers}/chocolatey.ts

@@ -28,7 +28,11 @@ interface NuGetODataResponse {
 /**
  * Handle Chocolatey package URLs via NuGet v2 OData API
  */
-export const handleChocolatey: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleChocolatey: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		if (!parsed.hostname.includes("chocolatey.org")) return null;
@@ -53,6 +57,7 @@ export const handleChocolatey: SpecialHandler = async (url: string, timeout: num
 
 		const result = await loadPage(apiUrl, {
 			timeout,
+			signal,
 			headers: {
 				Accept: "application/json",
 			},

package/src/core/tools/web-scrapers/choosealicense.ts

@@ -0,0 +1,110 @@
+import { parseFrontmatter } from "../../../discovery/helpers";
+import type { RenderResult, SpecialHandler } from "./types";
+import { finalizeOutput, loadPage } from "./types";
+
+const ALLOWED_HOSTS = new Set(["choosealicense.com", "www.choosealicense.com"]);
+const LICENSE_PATH = /^\/licenses\/([^/]+)\/?$/i;
+const APPENDIX_PATH = /^\/appendix\/?$/i;
+
+function asString(value: unknown): string | undefined {
+	if (typeof value !== "string") return undefined;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : undefined;
+}
+
+function normalizeList(value: unknown): string[] {
+	if (Array.isArray(value)) {
+		return value
+			.filter((item): item is string => typeof item === "string")
+			.map((item) => item.trim())
+			.filter((item) => item.length > 0);
+	}
+	if (typeof value === "string") {
+		return value
+			.split(",")
+			.map((item) => item.trim())
+			.filter((item) => item.length > 0);
+	}
+	return [];
+}
+
+function formatLabel(value: string): string {
+	const cleaned = value.replace(/[-_]+/g, " ").replace(/\s+/g, " ").trim();
+	if (!cleaned) return value;
+	return cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
+}
+
+function formatSection(title: string, items: string[]): string {
+	let md = `## ${title}\n\n`;
+	if (items.length === 0) {
+		md += "- None listed\n\n";
+		return md;
+	}
+	for (const item of items) {
+		md += `- ${formatLabel(item)}\n`;
+	}
+	md += "\n";
+	return md;
+}
+
+export const handleChooseALicense: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
+	try {
+		const parsed = new URL(url);
+		if (!ALLOWED_HOSTS.has(parsed.hostname)) return null;
+
+		const licenseMatch = parsed.pathname.match(LICENSE_PATH);
+		const isAppendix = APPENDIX_PATH.test(parsed.pathname);
+		if (!licenseMatch && !isAppendix) return null;
+
+		const licenseSlug = licenseMatch ? decodeURIComponent(licenseMatch[1]).toLowerCase() : "appendix";
+		const rawUrl = licenseMatch
+			? `https://raw.githubusercontent.com/github/choosealicense.com/gh-pages/_licenses/${licenseSlug}.txt`
+			: "https://raw.githubusercontent.com/github/choosealicense.com/gh-pages/_pages/appendix.md";
+
+		const fetchedAt = new Date().toISOString();
+		const result = await loadPage(rawUrl, { timeout, headers: { Accept: "text/plain" }, signal });
+		if (!result.ok) return null;
+
+		const { frontmatter, body } = parseFrontmatter(result.content);
+
+		const title = asString(frontmatter.title) ?? formatLabel(licenseSlug);
+		const spdxId = asString(frontmatter["spdx-id"]) ?? "Unknown";
+		const description = asString(frontmatter.description);
+		const permissions = normalizeList(frontmatter.permissions);
+		const conditions = normalizeList(frontmatter.conditions);
+		const limitations = normalizeList(frontmatter.limitations);
+
+		let md = `# ${title}\n\n`;
+		if (description) md += `${description}\n\n`;
+
+		md += `**SPDX ID:** ${spdxId}\n`;
+		md += `**Source:** https://choosealicense.com${isAppendix ? "/appendix" : `/licenses/${licenseSlug}/`}\n\n`;
+
+		md += formatSection("Permissions", permissions);
+		md += formatSection("Conditions", conditions);
+		md += formatSection("Limitations", limitations);
+
+		const licenseText = body.trim();
+		if (licenseText.length > 0) {
+			md += `---\n\n## License Text\n\n${licenseText}\n`;
+		}
+
+		const output = finalizeOutput(md);
+		return {
+			url,
+			finalUrl: url,
+			contentType: "text/markdown",
+			method: "choosealicense",
+			content: output.content,
+			fetchedAt,
+			truncated: output.truncated,
+			notes: ["Fetched via Choose a License"],
+		};
+	} catch {}
+
+	return null;
+};

package/src/core/tools/web-scrapers/cisa-kev.ts

@@ -0,0 +1,100 @@
+import type { RenderResult, SpecialHandler } from "./types";
+import { finalizeOutput, loadPage } from "./types";
+
+interface KevEntry {
+	cveID: string;
+	vendorProject?: string;
+	product?: string;
+	vulnerabilityName?: string;
+	shortDescription?: string;
+	requiredAction?: string;
+	dateAdded?: string;
+	dueDate?: string;
+}
+
+interface KevCatalog {
+	title?: string;
+	catalogVersion?: string;
+	dateReleased?: string;
+	count?: number;
+	vulnerabilities?: KevEntry[];
+}
+
+const CVE_PATTERN = /CVE-\d{4}-\d{4,7}/i;
+const KEV_FEED_URL = "https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json";
+
+/**
+ * Handle CISA Known Exploited Vulnerabilities (KEV) URLs
+ */
+export const handleCisaKev: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
+	try {
+		const parsed = new URL(url);
+		const hostname = parsed.hostname.toLowerCase();
+		if (!hostname.endsWith("cisa.gov")) return null;
+
+		const path = parsed.pathname.toLowerCase();
+		if (!path.includes("known-exploited-vulnerabilities")) return null;
+
+		const cveMatch = parsed.pathname.match(CVE_PATTERN) ?? parsed.search.match(CVE_PATTERN);
+		if (!cveMatch) return null;
+
+		const cveId = cveMatch[0].toUpperCase();
+		const fetchedAt = new Date().toISOString();
+
+		const result = await loadPage(KEV_FEED_URL, {
+			timeout,
+			headers: { Accept: "application/json" },
+			signal,
+		});
+
+		if (!result.ok) return null;
+
+		let data: KevCatalog;
+		try {
+			data = JSON.parse(result.content) as KevCatalog;
+		} catch {
+			return null;
+		}
+
+		const entry = data.vulnerabilities?.find((item) => item.cveID?.toUpperCase() === cveId);
+		if (!entry) return null;
+
+		let md = `# ${entry.cveID}\n\n`;
+		if (entry.vulnerabilityName) {
+			md += `${entry.vulnerabilityName}\n\n`;
+		}
+
+		md += "## Metadata\n\n";
+		if (entry.vendorProject) md += `**Vendor:** ${entry.vendorProject}\n`;
+		if (entry.product) md += `**Product:** ${entry.product}\n`;
+		if (entry.dateAdded) md += `**Date Added:** ${entry.dateAdded}\n`;
+		if (entry.dueDate) md += `**Due Date:** ${entry.dueDate}\n`;
+		md += "\n";
+
+		if (entry.shortDescription) {
+			md += `## Description\n\n${entry.shortDescription}\n\n`;
+		}
+
+		if (entry.requiredAction) {
+			md += `## Required Action\n\n${entry.requiredAction}\n\n`;
+		}
+
+		const output = finalizeOutput(md);
+		return {
+			url,
+			finalUrl: url,
+			contentType: "text/markdown",
+			method: "cisa-kev",
+			content: output.content,
+			fetchedAt,
+			truncated: output.truncated,
+			notes: ["Fetched via CISA KEV feed"],
+		};
+	} catch {}
+
+	return null;
+};

package/src/core/tools/web-scrapers/clojars.ts

@@ -0,0 +1,180 @@
+import type { RenderResult, SpecialHandler } from "./types";
+import { finalizeOutput, formatCount, loadPage } from "./types";
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return typeof value === "object" && value !== null;
+}
+
+function asString(value: unknown): string | null {
+	if (typeof value !== "string") return null;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : null;
+}
+
+function asNumber(value: unknown): number | null {
+	return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+function formatLicenses(licenses: unknown): string[] {
+	if (!Array.isArray(licenses)) return [];
+	const output: string[] = [];
+	for (const license of licenses) {
+		if (typeof license === "string") {
+			const trimmed = license.trim();
+			if (trimmed) output.push(trimmed);
+			continue;
+		}
+		if (isRecord(license)) {
+			const name = asString(license.name);
+			const url = asString(license.url);
+			if (name && url) {
+				output.push(`${name} (${url})`);
+			} else if (name) {
+				output.push(name);
+			} else if (url) {
+				output.push(url);
+			}
+		}
+	}
+	return output;
+}
+
+function formatDependencies(deps: unknown): string[] {
+	const output: string[] = [];
+	if (Array.isArray(deps)) {
+		for (const dep of deps) {
+			if (typeof dep === "string") {
+				const trimmed = dep.trim();
+				if (trimmed) output.push(trimmed);
+				continue;
+			}
+			if (Array.isArray(dep)) {
+				const name = asString(dep[0]);
+				const version = asString(dep[1]);
+				if (name && version) {
+					output.push(`${name}: ${version}`);
+				} else if (name) {
+					output.push(name);
+				}
+				continue;
+			}
+			if (isRecord(dep)) {
+				const name = asString(dep.name) ?? asString(dep.artifact) ?? asString(dep.jar_name);
+				const version = asString(dep.version);
+				if (name && version) {
+					output.push(`${name}: ${version}`);
+				} else if (name) {
+					output.push(name);
+				}
+			}
+		}
+		return output;
+	}
+
+	if (isRecord(deps)) {
+		for (const [name, version] of Object.entries(deps)) {
+			const versionText = asString(version);
+			if (versionText) {
+				output.push(`${name}: ${versionText}`);
+			} else if (name.trim()) {
+				output.push(name);
+			}
+		}
+	}
+
+	return output;
+}
+
+/**
+ * Handle Clojars URLs via API
+ */
+export const handleClojars: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
+	try {
+		const parsed = new URL(url);
+		if (parsed.hostname !== "clojars.org" && parsed.hostname !== "www.clojars.org") return null;
+
+		const path = parsed.pathname.replace(/^\/+|\/+$/g, "");
+		if (!path) return null;
+
+		const segments = path.split("/").filter(Boolean);
+		if (segments.length < 1 || segments.length > 2) return null;
+
+		const groupFromUrl = segments.length === 2 ? decodeURIComponent(segments[0]) : null;
+		const artifactFromUrl = decodeURIComponent(segments[segments.length - 1]);
+
+		const apiUrl =
+			segments.length === 2
+				? `https://clojars.org/api/artifacts/${encodeURIComponent(groupFromUrl ?? "")}/${encodeURIComponent(artifactFromUrl)}`
+				: `https://clojars.org/api/artifacts/${encodeURIComponent(artifactFromUrl)}`;
+
+		const fetchedAt = new Date().toISOString();
+
+		const result = await loadPage(apiUrl, {
+			timeout,
+			headers: { Accept: "application/json" },
+			signal,
+		});
+
+		if (!result.ok) return null;
+
+		let payload: unknown;
+		try {
+			payload = JSON.parse(result.content);
+		} catch {
+			return null;
+		}
+
+		const data = Array.isArray(payload) ? payload[0] : payload;
+		if (!isRecord(data)) return null;
+
+		const groupName = asString(data.group_name) ?? asString(data.group) ?? groupFromUrl;
+		const artifactName = asString(data.jar_name) ?? asString(data.artifact) ?? asString(data.name) ?? artifactFromUrl;
+		const version = asString(data.latest_version) ?? asString(data.version);
+		const description = asString(data.description) ?? asString(data.summary);
+		const downloads =
+			asNumber(data.downloads) ?? asNumber(data.downloads_total) ?? asNumber(data.total_downloads) ?? null;
+		const homepage = asString(data.homepage) ?? asString(data.url);
+		const licenses = formatLicenses(data.licenses);
+		const dependencies = formatDependencies(data.dependencies ?? data.deps);
+
+		const displayName =
+			groupName && artifactName && groupName !== artifactName
+				? `${groupName}/${artifactName}`
+				: (artifactName ?? groupName ?? "Clojars artifact");
+
+		let md = `# ${displayName}\n\n`;
+		if (description) md += `${description}\n\n`;
+
+		if (groupName) md += `**Group:** ${groupName}\n`;
+		if (artifactName) md += `**Artifact:** ${artifactName}\n`;
+		if (version) md += `**Latest:** ${version}\n`;
+		if (downloads !== null) md += `**Downloads:** ${formatCount(downloads)}\n`;
+		if (homepage) md += `**Homepage:** ${homepage}\n`;
+		if (licenses.length > 0) md += `**Licenses:** ${licenses.join(", ")}\n`;
+
+		if (dependencies.length > 0) {
+			md += "\n## Dependencies\n\n";
+			for (const dep of dependencies) {
+				md += `- ${dep}\n`;
+			}
+		}
+
+		const output = finalizeOutput(md);
+		return {
+			url,
+			finalUrl: url,
+			contentType: "text/markdown",
+			method: "clojars",
+			content: output.content,
+			fetchedAt,
+			truncated: output.truncated,
+			notes: ["Fetched via Clojars API"],
+		};
+	} catch {}
+
+	return null;
+};

package/src/core/tools/{web-fetch-handlers → web-scrapers}/coingecko.ts

@@ -29,7 +29,11 @@ interface CoinGeckoResponse {
 /**
  * Handle CoinGecko cryptocurrency URLs via API
  */
-export const handleCoinGecko: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleCoinGecko: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		if (!parsed.hostname.includes("coingecko.com")) return null;
@@ -46,6 +50,7 @@ export const handleCoinGecko: SpecialHandler = async (url: string, timeout: numb
 		const result = await loadPage(apiUrl, {
 			timeout,
 			headers: { Accept: "application/json" },
+			signal,
 		});
 
 		if (!result.ok) return null;

package/src/core/tools/{web-fetch-handlers → web-scrapers}/crates-io.ts

@@ -17,7 +17,11 @@ function looksLikeHtml(content: string): boolean {
 /**
  * Handle crates.io URLs via API
  */
-export const handleCratesIo: SpecialHandler = async (url: string, timeout: number): Promise<RenderResult | null> => {
+export const handleCratesIo: SpecialHandler = async (
+	url: string,
+	timeout: number,
+	signal?: AbortSignal,
+): Promise<RenderResult | null> => {
 	try {
 		const parsed = new URL(url);
 		if (parsed.hostname !== "crates.io" && parsed.hostname !== "www.crates.io") return null;
@@ -33,6 +37,7 @@ export const handleCratesIo: SpecialHandler = async (url: string, timeout: numbe
 		const apiUrl = `https://crates.io/api/v1/crates/${crateName}`;
 		const result = await loadPage(apiUrl, {
 			timeout,
+			signal,
 			headers: { "User-Agent": "omp-web-fetch/1.0 (https://github.com/anthropics)" },
 		});
 
@@ -101,7 +106,7 @@ export const handleCratesIo: SpecialHandler = async (url: string, timeout: numbe
 
 		// Try to fetch README from docs.rs or repository
 		const docsRsUrl = `https://docs.rs/crate/${crateName}/${crate.max_version}/source/README.md`;
-		const readmeResult = await loadPage(docsRsUrl, { timeout: Math.min(timeout, 5) });
+		const readmeResult = await loadPage(docsRsUrl, { timeout: Math.min(timeout, 5), signal });
 		if (readmeResult.ok && readmeResult.content.length > 100 && !looksLikeHtml(readmeResult.content)) {
 			md += `\n---\n\n## README\n\n${readmeResult.content}\n`;
 		}