seo 0.10.0 → 0.12.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { n as version, t as load } from "./esm-CM7xTOjT.js";
+import { n as version, t as load } from "./esm-CQJgJ8TD.js";
 import { SEO_PROVIDER_API_VERSION } from "./provider-sdk.js";
 import crypto, { createHash, randomUUID, sign } from "node:crypto";
 import { z } from "zod";
@@ -27,6 +27,7 @@ import { TextDecoder as TextDecoder$1, promisify } from "node:util";
 import { execFile } from "node:child_process";
 import pino from "pino";
 import pretty from "pino-pretty";
+import { request } from "node:https";
 //#region packages/core/src/analytics/providers.ts
 const ANALYTICS_PROVIDER_IDS = ["google", "clicky"];
 const ANALYTICS_PROVIDER_DETAILS = {
@@ -1613,7 +1614,7 @@ async function googleJson(gfetch, url, input) {
 	return readJson(response, input.label, { maxBytes: input.maxBytes });
 }
 const GSC = "https://www.googleapis.com/webmasters/v3";
-const PAGE_ROWS = 25e3;
+const PAGE_ROWS$1 = 25e3;
 async function searchAnalyticsRows(gfetch, site, body, options) {
 	const rows = [];
 	const { maxRows: requested, ...apiBody } = body;
@@ -1624,7 +1625,7 @@ async function searchAnalyticsRows(gfetch, site, body, options) {
 	while (true) {
 		const remaining = typeof maxRows === "number" ? maxRows - rows.length : void 0;
 		if (typeof remaining === "number" && remaining <= 0) break;
-		const rowLimit = Math.min(apiBody.rowLimit ?? PAGE_ROWS, remaining ?? PAGE_ROWS, PAGE_ROWS);
+		const rowLimit = Math.min(apiBody.rowLimit ?? PAGE_ROWS$1, remaining ?? PAGE_ROWS$1, PAGE_ROWS$1);
 		const json = await googleJson(gfetch, url, {
 			...options,
 			label: "Search Console",
@@ -1701,7 +1702,7 @@ async function runAnalyticsReport(gfetch, propertyId, body, options) {
 //#endregion
 //#region packages/core/src/bing/api.ts
 const BASE = "https://ssl.bing.com/webmaster/api.svc/json";
-const MAX_BYTES$2 = 8e6;
+const MAX_BYTES$4 = 8e6;
 function bingCall(auth, options) {
 	return async (method, params = {}) => {
 		const url = new URL(`${BASE}/${method}`);
@@ -1726,7 +1727,7 @@ function bingCall(auth, options) {
 			if (response.status === 429 || /throttle/i.test(detail)) throw new SeoError("RATE_LIMITED", "Bing Webmaster is limiting requests. Try again in a few minutes.");
 			throw new SeoError("OPTIONAL_PROVIDER_UNAVAILABLE", `Bing Webmaster answered ${response.status}. ${detail}`.trim());
 		}
-		return (await readJson(response, "Bing Webmaster", { maxBytes: MAX_BYTES$2 })).d;
+		return (await readJson(response, "Bing Webmaster", { maxBytes: MAX_BYTES$4 })).d;
 	};
 }
 //#endregion
@@ -4262,6 +4263,7 @@ const CACHE_MAX_BYTES = 256 * MEBIBYTE$2;
 const CACHE_MAX_AGE_MS = 720 * 60 * 60 * 1e3;
 const CACHE_LIMITS = {
 	gsc_cache: 48 * MEBIBYTE$2,
+	url_inspection_cache: 16 * MEBIBYTE$2,
 	ga4_cache: 24 * MEBIBYTE$2,
 	provider_cache: 32 * MEBIBYTE$2,
 	http_cache: 128 * MEBIBYTE$2,
@@ -4279,6 +4281,16 @@ const CACHE_POLICIES = [
 			"response_json"
 		]
 	},
+	{
+		table: "url_inspection_cache",
+		keys: ["site_url", "url"],
+		timestamp: "fetched_at",
+		sizeColumns: [
+			"site_url",
+			"url",
+			"status_json"
+		]
+	},
 	{
 		table: "ga4_cache",
 		keys: ["property_id", "query_hash"],
@@ -4582,6 +4594,17 @@ CREATE INDEX IF NOT EXISTS idx_url_inspection_reservations_minute
     credential_key, property_site_url, created_at
   );
 
+CREATE TABLE IF NOT EXISTS url_inspection_cache (
+  site_url TEXT NOT NULL,
+  url TEXT NOT NULL,
+  status_json TEXT NOT NULL,
+  fetched_at INTEGER NOT NULL,
+  expires_at INTEGER NOT NULL,
+  PRIMARY KEY(site_url, url)
+) WITHOUT ROWID;
+CREATE INDEX IF NOT EXISTS idx_url_inspection_cache_expires
+  ON url_inspection_cache(expires_at);
+
 CREATE TABLE IF NOT EXISTS performance_reports (
   id TEXT PRIMARY KEY,
   url TEXT NOT NULL,
@@ -4614,10 +4637,12 @@ function initDb(database, isNewDatabase) {
 		database.exec("DROP TABLE IF EXISTS provider_spend_notices");
 		ensureColumn(database, "http_cache", "metadata_json", "TEXT");
 	}).immediate();
-	runCacheMaintenance(database, {
-		compact: true,
-		allowFullVacuum: true
-	});
+	try {
+		runCacheMaintenance(database, {
+			compact: true,
+			allowFullVacuum: true
+		});
+	} catch {}
 }
 function getDb() {
 	if (db) return db;
@@ -4628,12 +4653,41 @@ function getDb() {
 		mode: 448
 	});
 	ensurePrivateDatabaseFiles(path);
-	db = new SqliteDatabase(path);
-	ensurePrivateDatabaseFiles(path);
-	initDb(db, isNewDatabase);
-	ensurePrivateDatabaseFiles(path);
+	const opened = new SqliteDatabase(path);
+	try {
+		ensurePrivateDatabaseFiles(path);
+		initDb(opened, isNewDatabase);
+		ensurePrivateDatabaseFiles(path);
+	} catch (error) {
+		opened.close();
+		throw error;
+	}
+	db = opened;
 	return db;
 }
+let memoryDb;
+function memoryCache() {
+	if (!memoryDb) {
+		memoryDb = new SqliteDatabase(":memory:");
+		memoryDb.exec(CREATE_SQL);
+	}
+	return memoryDb;
+}
+function cacheDb() {
+	if (memoryDb) return memoryDb;
+	try {
+		return getDb();
+	} catch {
+		return memoryCache();
+	}
+}
+function writeToCache(write) {
+	try {
+		write(cacheDb());
+	} catch {
+		memoryCache();
+	}
+}
 function noteCacheWrite(sizeBytes = 0, database = getDb()) {
 	const counter = cacheMaintenanceCounters.get(database) ?? {
 		writes: 0,
@@ -4662,6 +4716,7 @@ function getCacheStats() {
 	const counts = {
 		sites: database.prepare("SELECT COUNT(*) AS count FROM sites").get(),
 		gsc_cache: database.prepare("SELECT COUNT(*) AS count FROM gsc_cache").get(),
+		url_inspection_cache: database.prepare("SELECT COUNT(*) AS count FROM url_inspection_cache").get(),
 		google_analytics_cache: database.prepare("SELECT COUNT(*) AS count FROM ga4_cache").get(),
 		provider_cache: { count: providerCount("dataforseo") },
 		ahrefs_cache: { count: providerCount("ahrefs") },
@@ -4693,8 +4748,9 @@ function clearCache(provider, olderThanMs) {
 		compactCacheDatabase(database, { allowFullVacuum: true });
 		return info.changes;
 	}
-	const tables = provider === "gsc" ? ["gsc_cache"] : provider === "google-analytics" ? ["ga4_cache"] : provider === "http" ? ["http_cache"] : [
+	const tables = provider === "gsc" ? ["gsc_cache", "url_inspection_cache"] : provider === "google-analytics" ? ["ga4_cache"] : provider === "http" ? ["http_cache"] : [
 		"gsc_cache",
+		"url_inspection_cache",
 		"ga4_cache",
 		"provider_cache",
 		"http_cache"
@@ -4715,7 +4771,7 @@ function ga4RequestCanUseCache(body) {
 }
 async function runGa4Report(propertyId, body, opts = {}) {
 	const { client, identity } = await createGoogleAccessTokenClient(opts.accountEmail);
-	const db = getDb();
+	const db = cacheDb();
 	const queryHash = hashKey([
 		propertyId,
 		identity,
@@ -4728,10 +4784,12 @@ async function runGa4Report(propertyId, body, opts = {}) {
 	if (cacheable) {
 		const requestJson = JSON.stringify(body);
 		const responseJson = JSON.stringify(result);
-		db.prepare(`INSERT OR REPLACE INTO ga4_cache
-    (property_id, query_hash, request_json, response_json, row_count, fetched_at, expires_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?)`).run(propertyId, queryHash, requestJson, responseJson, result.rowCount ?? result.rows?.length ?? 0, Date.now(), Date.now() + 864e5);
-		noteCacheWrite(Buffer.byteLength(requestJson) + Buffer.byteLength(responseJson));
+		writeToCache((database) => {
+			database.prepare(`INSERT OR REPLACE INTO ga4_cache
+          (property_id, query_hash, request_json, response_json, row_count, fetched_at, expires_at)
+          VALUES (?, ?, ?, ?, ?, ?, ?)`).run(propertyId, queryHash, requestJson, responseJson, result.rowCount ?? result.rows?.length ?? 0, Date.now(), Date.now() + 864e5);
+			noteCacheWrite(Buffer.byteLength(requestJson) + Buffer.byteLength(responseJson), database);
+		});
 	}
 	return result;
 }
@@ -7190,7 +7248,7 @@ async function fetchRobotsSource(origin, refresh, options) {
 	const robotsUrl = new URL("/robots.txt", origin).toString();
 	const key = hashKey(["robots", robotsUrl]);
 	if (!refresh) {
-		const cached = getDb().prepare("SELECT status, body_blob, expires_at FROM http_cache WHERE url_hash = ?").get(key);
+		const cached = cacheDb().prepare("SELECT status, body_blob, expires_at FROM http_cache WHERE url_hash = ?").get(key);
 		if (cached?.body_blob && cached.status !== void 0 && cacheableStatus(cached.status) && cached.expires_at && cached.expires_at > Date.now()) return {
 			robotsUrl,
 			status: cached.status,
@@ -7209,12 +7267,12 @@ async function fetchRobotsSource(origin, refresh, options) {
 			signal: controller.signal
 		});
 		const text = await readBoundedResponseText(response, MAX_ROBOTS_RESPONSE_BYTES, "robots.txt response");
-		if (options.writeCache !== false && cacheableStatus(response.status)) {
-			getDb().prepare(`INSERT OR REPLACE INTO http_cache
-          (url_hash, url, status, headers_json, body_blob, etag, fetched_at, expires_at)
-          VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(key, robotsUrl, response.status, "{}", Buffer.from(text), null, Date.now(), Date.now() + 864e5);
-			noteCacheWrite(Buffer.byteLength(text));
-		}
+		if (options.writeCache !== false && cacheableStatus(response.status)) writeToCache((database) => {
+			database.prepare(`INSERT OR REPLACE INTO http_cache
+            (url_hash, url, status, headers_json, body_blob, etag, fetched_at, expires_at)
+            VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(key, robotsUrl, response.status, "{}", Buffer.from(text), null, Date.now(), Date.now() + 864e5);
+			noteCacheWrite(Buffer.byteLength(text), database);
+		});
 		return {
 			robotsUrl,
 			status: response.status,
@@ -7321,7 +7379,6 @@ function decodePageFetchCacheEvidence(value) {
 }
 async function fetchPlain(url, refresh = false, timeoutMs = 2e4, rate, signal, respectRobots = false, writeCache = true) {
 	const startedAt = Date.now();
-	const db = getDb();
 	const key = hashKey(["page", url]);
 	const host = new URL(url).host;
 	let robots = respectRobots ? await fetchRobots(new URL(url).origin, url, refresh, {
@@ -7329,7 +7386,7 @@ async function fetchPlain(url, refresh = false, timeoutMs = 2e4, rate, signal, r
 		signal
 	}) : void 0;
 	if (robots && robots.allowed !== true) throw new RobotsAccessError(robots.allowed === false ? "robots-disallowed" : "robots-deferred", robots);
-	const cached = db.prepare("SELECT status, headers_json, body_blob, metadata_json, expires_at FROM http_cache WHERE url_hash = ? AND expires_at > ?").get(key, Date.now());
+	const cached = cacheDb().prepare("SELECT status, headers_json, body_blob, metadata_json, expires_at FROM http_cache WHERE url_hash = ? AND expires_at > ?").get(key, Date.now());
 	if (!refresh && cached) {
 		const evidence = decodePageFetchCacheEvidence(cached.metadata_json);
 		return {
@@ -7431,12 +7488,12 @@ async function fetchPlain(url, refresh = false, timeoutMs = 2e4, rate, signal, r
 		warnings: [...robots.allowed === null ? [`robots.txt availability is unknown${robots.status ? ` after HTTP ${robots.status}` : ""}; this fetch does not prove crawler access is allowed.`] : [], ...accessBlock ? [`${accessBlock.guidance.summary} Identify the crawler as ${accessBlock.crawler.userAgent}.`] : []],
 		robotsTxt: pageRobotsEvidence(robots)
 	};
-	if (!accessBlock && writeCache) {
-		db.prepare(`INSERT OR REPLACE INTO http_cache
-      (url_hash, url, status, headers_json, body_blob, metadata_json, etag, fetched_at, expires_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(key, url, response.response.status, JSON.stringify(headerMap), Buffer.from(html), encodePageFetchCacheEvidence(result), response.response.headers.get("etag"), Date.now(), Date.now() + 36e5);
-		noteCacheWrite(Buffer.byteLength(html));
-	}
+	if (!accessBlock && writeCache) writeToCache((database) => {
+		database.prepare(`INSERT OR REPLACE INTO http_cache
+          (url_hash, url, status, headers_json, body_blob, metadata_json, etag, fetched_at, expires_at)
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(key, url, response.response.status, JSON.stringify(headerMap), Buffer.from(html), encodePageFetchCacheEvidence(result), response.response.headers.get("etag"), Date.now(), Date.now() + 36e5);
+		noteCacheWrite(Buffer.byteLength(html), database);
+	});
 	return result;
 }
 //#endregion
@@ -8189,6 +8246,19 @@ function reserveUrlInspectionQuota(input) {
 	if ("error" in result) throw result.error;
 	return result.reservation;
 }
+function readUrlInspectionQuota(input) {
+	const database = input.database ?? getDb();
+	const now = input.now ?? /* @__PURE__ */ new Date();
+	const bucket = database.prepare(`SELECT limit_count, used_count, reserved_count, blocked_until
+      FROM url_inspection_quota_buckets
+      WHERE credential_key = ? AND property_site_url = ? AND quota_date = ?`).get(input.credentialKey, input.property, urlInspectionQuotaDate(now));
+	const limit = bucket?.limit_count ?? 2e3;
+	return {
+		used: (bucket?.blocked_until ?? 0) > now.getTime() ? limit : Math.min(limit, (bucket?.used_count ?? 0) + (bucket?.reserved_count ?? 0)),
+		limit,
+		resetAt: urlInspectionQuotaResetAt(now).toISOString()
+	};
+}
 function finalizeUrlInspectionQuota(input) {
 	const database = input.database ?? getDb();
 	const now = input.now ?? /* @__PURE__ */ new Date();
@@ -8233,6 +8303,13 @@ function inspectionResponseError(response, input) {
 	if (response.status >= 500) return new SeoError("PROVIDER_UNAVAILABLE", `Google URL Inspection is unavailable (${response.status}). Try again later.`);
 	return new SeoError("PROVIDER_UNAVAILABLE", `URL Inspection failed with ${response.status}.`);
 }
+async function urlInspectionQuota(input) {
+	const { quotaIdentity } = await getAuthorized(input.accountEmail ?? await cloudAccountFor(input.siteUrl));
+	return readUrlInspectionQuota({
+		credentialKey: credentialKey(quotaIdentity),
+		property: input.siteUrl
+	});
+}
 async function inspectUrl(input) {
 	const inspectionUrl = assertUrlMatchesGscProperty(input.siteUrl, input.inspectionUrl);
 	const { client, quotaIdentity } = await getAuthorized(input.accountEmail ?? await cloudAccountFor(input.siteUrl));
@@ -8294,7 +8371,7 @@ function resolveSearchDateWindow(input = 28) {
 }
 async function querySearchAnalytics(site, body, opts = {}) {
 	const { client, identity } = await getAuthorized(opts.accountEmail ?? await cloudAccountFor(site));
-	const db = getDb();
+	const db = cacheDb();
 	const queryHash = hashKey([
 		site,
 		identity,
@@ -8314,10 +8391,12 @@ async function querySearchAnalytics(site, body, opts = {}) {
 	const calls = result.calls;
 	const requestJson = JSON.stringify(body);
 	const responseJson = JSON.stringify(allRows);
-	db.prepare(`INSERT OR REPLACE INTO gsc_cache
-    (site_url, query_hash, request_json, response_json, row_count, fetched_at, expires_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?)`).run(site, queryHash, requestJson, responseJson, allRows.length, Date.now(), Date.now() + 864e5);
-	noteCacheWrite(Buffer.byteLength(requestJson) + Buffer.byteLength(responseJson));
+	writeToCache((database) => {
+		database.prepare(`INSERT OR REPLACE INTO gsc_cache
+        (site_url, query_hash, request_json, response_json, row_count, fetched_at, expires_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?)`).run(site, queryHash, requestJson, responseJson, allRows.length, Date.now(), Date.now() + 864e5);
+		noteCacheWrite(Buffer.byteLength(requestJson) + Buffer.byteLength(responseJson), database);
+	});
 	return {
 		rows: allRows,
 		calls,
@@ -8453,8 +8532,10 @@ async function queryPagesTopQueriesBatch(site, pageUrls, range = 28) {
 //#region packages/core/src/gsc/client/sites.ts
 async function listSites(_refresh = false, accountEmail) {
 	const entries = !accountEmail && cloudLinked() ? await allCloudSites() : await listSearchConsoleSites(googleFetchFor((await getAuthorized(accountEmail)).client), LOCAL_SIGN_IN);
-	const insert = getDb().prepare("INSERT OR REPLACE INTO sites (site_url, display_name, permission, added_at, is_default) VALUES (?, ?, ?, ?, COALESCE((SELECT is_default FROM sites WHERE site_url = ?), 0))");
-	for (const site of entries) insert.run(site.siteUrl, site.siteUrl, site.permissionLevel ?? null, Date.now(), site.siteUrl);
+	writeToCache((database) => {
+		const insert = database.prepare("INSERT OR REPLACE INTO sites (site_url, display_name, permission, added_at, is_default) VALUES (?, ?, ?, ?, COALESCE((SELECT is_default FROM sites WHERE site_url = ?), 0))");
+		for (const site of entries) insert.run(site.siteUrl, site.siteUrl, site.permissionLevel ?? null, Date.now(), site.siteUrl);
+	});
 	return entries;
 }
 async function allCloudSites() {
@@ -10132,7 +10213,7 @@ const actionPriority = new Map([
 	"unverified",
 	"covered"
 ].map((type, index) => [type, index]));
-function plural$6(count, singular, pluralLabel) {
+function plural$7(count, singular, pluralLabel) {
 	return count === 1 ? singular : pluralLabel;
 }
 function actionable(item) {
@@ -10166,7 +10247,7 @@ function pageOpportunityVerdict(input) {
 	if (focus === "unverified") return "GSC visibility exists, but the page was not verified and no specific change is justified yet.";
 	if (focus === "covered") return "The verified page covers the sampled queries and CTR is not materially below its directional benchmark.";
 	const count = analysis.summary.opportunities;
-	const prefix = `${count} ${plural$6(count, "actionable observation", "actionable observations")} found.`;
+	const prefix = `${count} ${plural$7(count, "actionable observation", "actionable observations")} found.`;
 	if (focus === "content-gap") return `${prefix} Verified body coverage is the main issue; confirm intent before expanding the page.`;
 	if (focus === "serp-framing") return `${prefix} The body is relevant, but its title, meta description, or H1 framing is weak.`;
 	if (focus === "ranking") return `${prefix} Most upside requires stronger relevance or authority; no CTR-only lift is claimed for page-two queries.`;
@@ -10181,7 +10262,7 @@ function pageOpportunityRecommendations(analysis) {
 	}
 	const recommendations = [`Start with "${top.query}". ${top.recommendation}`];
 	const technical = actions.filter((item) => item.opportunityType === "technical-check").length;
-	if (technical) recommendations.push(`Resolve the technical evidence affecting ${technical} ${plural$6(technical, "row", "rows")} before content work.`);
+	if (technical) recommendations.push(`Resolve the technical evidence affecting ${technical} ${plural$7(technical, "row", "rows")} before content work.`);
 	const gaps = actions.filter((item) => item.opportunityType === "content-gap").length;
 	if (gaps >= 3) recommendations.push(`Group the ${gaps} verified content gaps into useful sections rather than adding one thin paragraph per query.`);
 	return recommendations;
@@ -14185,7 +14266,7 @@ function availabilityOf(status) {
 function errorText(error) {
 	return error instanceof Error ? error.message : String(error);
 }
-async function get(input, url, headers, readBody = true) {
+async function get$1(input, url, headers, readBody = true) {
 	const controller = abortController({
 		timeoutMs: input.timeoutMs,
 		signal: input.signal
@@ -14242,7 +14323,7 @@ function llmsLinks(text, base) {
 	return links;
 }
 async function checkLlmsTxt(input) {
-	const result = await get(input, new URL("/llms.txt", input.url).toString());
+	const result = await get$1(input, new URL("/llms.txt", input.url).toString());
 	const availability = result.availability === "available" && isHtml(result.contentType) ? "absent" : result.availability;
 	const exists = availability === "available";
 	const base = {
@@ -14259,7 +14340,7 @@ async function checkLlmsTxt(input) {
 	for (const url of found.slice(0, LLMS_LINK_LIMIT)) {
 		if (input.signal?.aborted) break;
 		checked += 1;
-		const link = brokenLink(await get(input, url, void 0, false), false);
+		const link = brokenLink(await get$1(input, url, void 0, false), false);
 		if (link) broken.push(link);
 	}
 	return {
@@ -14303,7 +14384,7 @@ function sitemapUrlsFromRobots(text) {
 	return [...urls];
 }
 async function checkRobotsAiAccess(input) {
-	const result = await get(input, new URL("/robots.txt", input.url).toString());
+	const result = await get$1(input, new URL("/robots.txt", input.url).toString());
 	const exists = result.availability === "available";
 	const unknown = result.availability === "rate-limited" || result.availability === "unreachable";
 	const declared = exists ? declaredUserAgents(result.text) : /* @__PURE__ */ new Set();
@@ -14332,7 +14413,7 @@ async function checkAgentResources(input) {
 	const resources = [];
 	for (const path of AGENT_RESOURCE_PATHS) {
 		if (input.signal?.aborted) break;
-		const result = await get(input, new URL(path, input.url).toString());
+		const result = await get$1(input, new URL(path, input.url).toString());
 		const exists = result.availability === "available" && !isHtml(result.contentType);
 		let validJson;
 		if (exists && /\bjson\b/i.test(result.contentType)) try {
@@ -14352,7 +14433,7 @@ async function checkAgentResources(input) {
 	return resources;
 }
 async function checkMarkdownNegotiation(input) {
-	const result = await get(input, input.url, { accept: "text/markdown" }, false);
+	const result = await get$1(input, input.url, { accept: "text/markdown" }, false);
 	const vary = result.headers?.get("vary") ?? "";
 	return {
 		url: result.url,
@@ -14399,7 +14480,7 @@ async function checkMarkdownCopies(input) {
 		const url = page.markdownAlternates?.[0];
 		if (!url || !input.allows(url)) continue;
 		checked += 1;
-		const result = await get({
+		const result = await get$1({
 			...input,
 			url
 		}, url);
@@ -15565,7 +15646,7 @@ function taskIds(value) {
 	}
 }
 function readProviderCache(key, schema, options = {}) {
-	const database = options.database ?? getDb();
+	const database = options.database ?? cacheDb();
 	const now = options.now ?? Date.now();
 	const hash = requestHash(key, stableProviderRequestJson(key.request));
 	const row = database.prepare(`SELECT response_json, row_count, source_cost_micros, task_ids_json,
@@ -15586,9 +15667,11 @@ function readProviderCache(key, schema, options = {}) {
 			taskIds: taskIds(row.task_ids_json)
 		};
 	} catch {
-		database.prepare(`DELETE FROM provider_cache
-         WHERE provider = ? AND credential_scope = ? AND operation = ?
-           AND request_hash = ?`).run(key.provider, key.credentialScope, key.operation, hash);
+		try {
+			database.prepare(`DELETE FROM provider_cache
+           WHERE provider = ? AND credential_scope = ? AND operation = ?
+             AND request_hash = ?`).run(key.provider, key.credentialScope, key.operation, hash);
+		} catch {}
 		return null;
 	}
 }
@@ -15599,19 +15682,22 @@ function writeProviderCache(key, input, options = {}) {
 		code: "configuration",
 		message: `Provider cache TTL must be between 1 and ${CACHE_MAX_AGE_MS} milliseconds.`
 	});
-	const database = options.database ?? getDb();
 	const now = options.now ?? Date.now();
 	const expiresAt = now + input.ttlMs;
 	const requestJson = stableProviderRequestJson(key.request);
 	const responseJson = JSON.stringify(input.data);
 	const normalizedTaskIds = [...new Set(input.taskIds)].filter((id) => id.length > 0 && id.length <= 100).sort((left, right) => left < right ? -1 : left > right ? 1 : 0).slice(0, 20);
 	const taskIdsJson = JSON.stringify(normalizedTaskIds);
-	database.prepare(`INSERT OR REPLACE INTO provider_cache (
-        provider, credential_scope, operation, request_hash, request_json,
-        response_json, row_count, source_cost_micros, task_ids_json,
-        fetched_at, expires_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(key.provider, key.credentialScope, key.operation, requestHash(key, requestJson), requestJson, responseJson, input.rowCount, input.sourceCostMicros, taskIdsJson, now, expiresAt);
-	noteCacheWrite(Buffer.byteLength(requestJson) + Buffer.byteLength(responseJson) + Buffer.byteLength(taskIdsJson), database);
+	const save = (database) => {
+		database.prepare(`INSERT OR REPLACE INTO provider_cache (
+          provider, credential_scope, operation, request_hash, request_json,
+          response_json, row_count, source_cost_micros, task_ids_json,
+          fetched_at, expires_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(key.provider, key.credentialScope, key.operation, requestHash(key, requestJson), requestJson, responseJson, input.rowCount, input.sourceCostMicros, taskIdsJson, now, expiresAt);
+		noteCacheWrite(Buffer.byteLength(requestJson) + Buffer.byteLength(responseJson) + Buffer.byteLength(taskIdsJson), database);
+	};
+	if (options.database) save(options.database);
+	else writeToCache(save);
 	return {
 		data: input.data,
 		storedAt: new Date(now).toISOString(),
@@ -16251,7 +16337,7 @@ const installedPackageJsonSchema = z.object({
 function packageDirectory(packagesDir, packageName) {
 	return join(packagesDir, "node_modules", ...packageName.split("/"));
 }
-function inside(parent, child) {
+function inside$1(parent, child) {
 	const path = relative(parent, child);
 	return path === "" || !path.startsWith("..") && !isAbsolute(path);
 }
@@ -16283,14 +16369,14 @@ async function loadOne(installed, registry, options) {
 async function loadProviderPackage(input, options) {
 	const importModule = options.importModule ?? ((url) => import(url));
 	const packageDir = realpathSync(packageDirectory(options.packagesDir, input.package));
-	if (!inside(realpathSync(options.packagesDir), packageDir)) throw new Error("Installed provider package resolves outside the provider directory.");
+	if (!inside$1(realpathSync(options.packagesDir), packageDir)) throw new Error("Installed provider package resolves outside the provider directory.");
 	const packageJsonPath = join(packageDir, "package.json");
 	const packageJson = installedPackageJsonSchema.parse(JSON.parse(readFileSync(packageJsonPath, "utf8")));
 	if (packageJson.name !== input.package || packageJson.version !== input.version) throw new Error("Installed provider package does not match its saved record.");
 	const packageRegistry = new ProviderExtensionRegistry();
 	for (const entry of packageJson.seo.providers) {
 		const entryPath = realpathSync(resolve(dirname(packageJsonPath), entry));
-		if (!inside(packageDir, entryPath)) throw new Error("Provider entry point resolves outside its package.");
+		if (!inside$1(packageDir, entryPath)) throw new Error("Provider entry point resolves outside its package.");
 		await providerActivate((await importModule(`${pathToFileURL(entryPath).href}?seo-provider=${encodeURIComponent(input.version)}`)).default)(packageRegistry.hostFor({
 			package: input.package,
 			version: input.version
@@ -16326,7 +16412,7 @@ async function loadInstalledProviderExtensions(options = {}) {
 const DEFAULT_MAX_REQUESTS = 8;
 const MAX_RESPONSE_BYTES$1 = 10 * 1024 * 1024;
 const MAX_REQUEST_BODY_BYTES = 64 * 1024;
-const TIMEOUT_MS$1 = 15e3;
+const TIMEOUT_MS$3 = 15e3;
 function normalizeProviderExtensionAccount(provider, account) {
 	const fields = provider.connection.fields.filter((field) => field.kind === "account");
 	const allowed = new Set(fields.map((field) => field.id));
@@ -16373,7 +16459,7 @@ function runtimeForProvider(provider, options = {}) {
 				},
 				fetch: providerFetch,
 				maxResponseBytes: MAX_RESPONSE_BYTES$1,
-				timeoutMs: TIMEOUT_MS$1,
+				timeoutMs: TIMEOUT_MS$3,
 				retry: (input.method ?? "GET") === "GET" ? "safe" : "never",
 				schema: z.unknown()
 			});
@@ -17954,7 +18040,7 @@ function analyzeCtrUnderperformersFromRows(input) {
 const MAX_GSC_ROWS$3 = 1e5;
 const DEFAULT_DAYS$3 = 28;
 const MAX_DAYS$2 = 548;
-function plural$5(count, singular, pluralLabel = `${singular}s`) {
+function plural$6(count, singular, pluralLabel = `${singular}s`) {
 	return count === 1 ? singular : pluralLabel;
 }
 async function ctrUnderperformersReportWith(input, dependencies) {
@@ -18057,11 +18143,11 @@ async function ctrUnderperformersReportWith(input, dependencies) {
 			minImpressions,
 			limit,
 			brandFiltering: input.includeBrand ? "included" : "excluded",
-			verdict: top ? `${selection.eligibleUnderperformers} CTR ${plural$5(selection.eligibleUnderperformers, "underperformer")} found in retained rows, with a calculated heuristic shortfall of ${totalClickShortfall.toFixed(0)} clicks for this window. Start review with "${top.query}" because it has the largest gap.` : dataStatus === "partial" ? "No material CTR underperformers remained in the validated retained rows, but partial evidence prevents an all-clear." : `No high-impression rows at average position below 4 in the retained rows are materially below the heuristic CTR benchmark.`
+			verdict: top ? `${selection.eligibleUnderperformers} CTR ${plural$6(selection.eligibleUnderperformers, "underperformer")} found in retained rows, with a calculated heuristic shortfall of ${totalClickShortfall.toFixed(0)} clicks for this window. Start review with "${top.query}" because it has the largest gap.` : dataStatus === "partial" ? "No material CTR underperformers remained in the validated retained rows, but partial evidence prevents an all-clear." : `No high-impression rows at average position below 4 in the retained rows are materially below the heuristic CTR benchmark.`
 		},
 		items,
 		caveats: [
-			`Date window: ${range.startDate} to ${range.endDate} (${days} ${plural$5(days, "day")}), using final GSC data where available.`,
+			`Date window: ${range.startDate} to ${range.endDate} (${days} ${plural$6(days, "day")}), using final GSC data where available.`,
 			`Brand queries: ${input.includeBrand ? "included" : "excluded"}. Brand terms used: ${brand.terms.join(", ") || "none"} (${brand.source === "provided" ? "provided" : "host forms, plus the bare domain stem only when Search Console shows the site is its navigational answer"}).`,
 			`Only rows at average position below 4 with at least ${minImpressions} impressions were checked. Rows at position 4 to 10 belong to quick-wins, which uses the same site CTR curve.`,
 			minImpressionsCaveat({
@@ -18069,13 +18155,13 @@ async function ctrUnderperformersReportWith(input, dependencies) {
 				belowMinimumRows: selection.belowMinimumRows
 			}),
 			"Expected CTR uses the site CTR curve from all page-one rows (75th percentile of qualified URL CTRs per position) when enough peer data exists, otherwise the fallback position curve.",
-			...selection.fragmentRows ? [`${selection.fragmentRows} source ${plural$5(selection.fragmentRows, "row")} with a #fragment URL ${selection.fragmentRows === 1 ? "was" : "were"} merged into the base URL.`] : [],
-			...selection.flaggedRows ? [`${selection.flaggedRows} eligible ${plural$5(selection.flaggedRows, "row")} carry heuristic query flags (likely-automated or navigational-other) and rank after unflagged rows.`] : [],
+			...selection.fragmentRows ? [`${selection.fragmentRows} source ${plural$6(selection.fragmentRows, "row")} with a #fragment URL ${selection.fragmentRows === 1 ? "was" : "were"} merged into the base URL.`] : [],
+			...selection.flaggedRows ? [`${selection.flaggedRows} eligible ${plural$6(selection.flaggedRows, "row")} carry heuristic query flags (likely-automated or navigational-other) and rank after unflagged rows.`] : [],
 			"CTR benchmarks and calculated click shortfalls are directional heuristics, not forecasts or proof that clicks are available. Validate the search intent and live SERP before editing.",
-			...selection.invalidRows ? [`${selection.invalidRows} invalid provider ${plural$5(selection.invalidRows, "row")} ${selection.invalidRows === 1 ? "was" : "were"} excluded, so this report is partial.`] : [],
-			...selection.duplicateRows ? [`${selection.duplicateRows} repeated query/page ${plural$5(selection.duplicateRows, "row")} ${selection.duplicateRows === 1 ? "was" : "were"} aggregated before CTR and average position were calculated.`] : [],
+			...selection.invalidRows ? [`${selection.invalidRows} invalid provider ${plural$6(selection.invalidRows, "row")} ${selection.invalidRows === 1 ? "was" : "were"} excluded, so this report is partial.`] : [],
+			...selection.duplicateRows ? [`${selection.duplicateRows} repeated query/page ${plural$6(selection.duplicateRows, "row")} ${selection.duplicateRows === 1 ? "was" : "were"} aggregated before CTR and average position were calculated.`] : [],
 			...possiblyTruncated ? [`The retained-row limit of ${MAX_GSC_ROWS$3} was reached, so lower-ranked source rows may be absent.`] : [],
-			...selection.limitedUnderperformers ? [`${selection.limitedUnderperformers} eligible ${plural$5(selection.limitedUnderperformers, "underperformer")} ${selection.limitedUnderperformers === 1 ? "was" : "were"} omitted by the output limit.`] : []
+			...selection.limitedUnderperformers ? [`${selection.limitedUnderperformers} eligible ${plural$6(selection.limitedUnderperformers, "underperformer")} ${selection.limitedUnderperformers === 1 ? "was" : "were"} omitted by the output limit.`] : []
 		],
 		recommendations: top ? [
 			`Review the live SERP and displayed snippet for "${top.query}" first. Test the title or meta description only if the observed framing does not match the query intent.`,
@@ -21910,7 +21996,7 @@ function anomalyEvidence(anomaly) {
 	if (anomaly.direction === "normal") return `${formatMetric(anomaly.metric)} changed ${changePhrase} (${anomaly.baselineMean.toLocaleString("en-GB")} -> ${anomaly.comparisonMean.toLocaleString("en-GB")} per observed day${anomaly.zScore === null ? "; the baseline had no observed variance" : `, z ${anomaly.zScore}`}).`;
 	return `${formatMetric(anomaly.metric)} ${direction} ${changePhrase} (${anomaly.baselineMean.toLocaleString("en-GB")} -> ${anomaly.comparisonMean.toLocaleString("en-GB")} per observed day${anomaly.zScore === null ? "; outside the flat observed baseline" : `, z ${anomaly.zScore}`}).`;
 }
-function plural$4(count, singular, pluralLabel = `${singular}s`) {
+function plural$5(count, singular, pluralLabel = `${singular}s`) {
 	return count === 1 ? singular : pluralLabel;
 }
 function strongestSignal(anomalies) {
@@ -21966,13 +22052,13 @@ function interpretUpdateCorrelation(input) {
 		summary,
 		evidence: [
 			...input.anomalies.map(anomalyEvidence),
-			hasUpdate ? `${input.overlappingUpdates.length} official Google Ranking update ${plural$4(input.overlappingUpdates.length, "window")} overlapped the change date or comparison window: ${updateNames.join(", ")}.` : "No official Google Ranking update windows overlapped the change date or comparison window.",
+			hasUpdate ? `${input.overlappingUpdates.length} official Google Ranking update ${plural$5(input.overlappingUpdates.length, "window")} overlapped the change date or comparison window: ${updateNames.join(", ")}.` : "No official Google Ranking update windows overlapped the change date or comparison window.",
 			largeMovement ? "Both clicks and impressions moved sharply in the same direction." : "Clicks and impressions did not both meet the sharp-movement evidence threshold.",
 			hasConfounders ? `Known overlapping site changes: ${confounders.map((confounder) => confounder.title).join("; ")}.` : "No overlapping site changes were supplied."
 		],
 		caveats: [
 			`GSC window: ${input.days} days; recent comparison window: ${input.recentDays} days.`,
-			`Update overlap padding: ${input.paddingDays} ${plural$4(input.paddingDays, "day")} either side of the step-change date, or of the recent comparison window when no step change was found.`,
+			`Update overlap padding: ${input.paddingDays} ${plural$5(input.paddingDays, "day")} either side of the step-change date, or of the recent comparison window when no step change was found.`,
 			input.refresh ? "Data freshness: cache bypassed for GSC data." : "Data freshness: local GSC cache may have been used.",
 			"Source: official Google Search Status Dashboard Ranking incidents only; third-party volatility and unconfirmed chatter are not included.",
 			"An update-window overlap cannot establish causation, even when movement is large and no known site change was recorded.",
@@ -22140,7 +22226,7 @@ function analyzeTrafficAnomalyRows(input) {
 		if (step && changeDate) {
 			const previousDate = aggregated.rows[step.index - 1]?.keys[0];
 			const gap = previousDate ? calendarDays(previousDate, changeDate) - 2 : 0;
-			stepCaveats.push(`${formatMetric(metric)} changed level on ${changeDate}, so its baseline is every observed day before that date and its comparison is every observed day from it.`, ...gap > 0 ? [`The ${metric} change date follows ${gap} missing ${plural$4(gap, "day")}; the change may have started on one of them.`] : []);
+			stepCaveats.push(`${formatMetric(metric)} changed level on ${changeDate}, so its baseline is every observed day before that date and its comparison is every observed day from it.`, ...gap > 0 ? [`The ${metric} change date follows ${gap} missing ${plural$5(gap, "day")}; the change may have started on one of them.`] : []);
 			return compareSegments({
 				site: input.site,
 				metric,
@@ -22171,9 +22257,9 @@ function analyzeTrafficAnomalyRows(input) {
 	const comparisonMissingDays = input.recentDays - comparisonRows.length;
 	const missingDays = expectedDays - aggregated.rows.length;
 	const caveats = [
-		...missingDays > 0 ? [`${missingDays} requested calendar ${plural$4(missingDays, "day")} had no returned date aggregate and ${missingDays === 1 ? "was" : "were"} not filled with zeros.`] : [],
-		...aggregated.invalidRows > 0 ? [`${aggregated.invalidRows} invalid provider ${plural$4(aggregated.invalidRows, "row")} ${aggregated.invalidRows === 1 ? "was" : "were"} excluded.`] : [],
-		...aggregated.duplicateRows > 0 ? [`${aggregated.duplicateRows} duplicate date ${plural$4(aggregated.duplicateRows, "row")} ${aggregated.duplicateRows === 1 ? "was" : "were"} aggregated before analysis.`] : [],
+		...missingDays > 0 ? [`${missingDays} requested calendar ${plural$5(missingDays, "day")} had no returned date aggregate and ${missingDays === 1 ? "was" : "were"} not filled with zeros.`] : [],
+		...aggregated.invalidRows > 0 ? [`${aggregated.invalidRows} invalid provider ${plural$5(aggregated.invalidRows, "row")} ${aggregated.invalidRows === 1 ? "was" : "were"} excluded.`] : [],
+		...aggregated.duplicateRows > 0 ? [`${aggregated.duplicateRows} duplicate date ${plural$5(aggregated.duplicateRows, "row")} ${aggregated.duplicateRows === 1 ? "was" : "were"} aggregated before analysis.`] : [],
 		...stepCaveats
 	];
 	return {
@@ -23254,7 +23340,7 @@ const VOID = /* @__PURE__ */ new Set([
 	"col",
 	"embed"
 ]);
-const ENTITIES = {
+const ENTITIES$1 = {
 	amp: "&",
 	lt: "<",
 	gt: ">",
@@ -23279,7 +23365,7 @@ function decode(text) {
 			const point = Number.parseInt(code.slice(hex ? 2 : 1), hex ? 16 : 10);
 			return point > 0 && point <= 1114111 ? String.fromCodePoint(point) : "";
 		}
-		return ENTITIES[code.toLowerCase()] ?? match;
+		return ENTITIES$1[code.toLowerCase()] ?? match;
 	});
 }
 const clean$1 = (value) => value.split(A_OPEN).join("").replace(/\s+/g, " ").trim();
@@ -23520,7 +23606,7 @@ var SentenceStore = class SentenceStore {
 		});
 	}
 };
-const bareHost = (host) => host.toLowerCase().replace(/^www\./, "");
+const bareHost$1 = (host) => host.toLowerCase().replace(/^www\./, "");
 function crawlUrl(value, base) {
 	try {
 		const url = base ? new URL(value, base) : new URL(value);
@@ -23586,10 +23672,10 @@ async function crawlForLinks(input) {
 async function crawl(input, robots, sentences, renderer, warnings) {
 	const start = crawlUrl(input.startUrl) ?? input.startUrl;
 	let origin = new URL(start).origin;
-	const site = bareHost(new URL(start).host);
+	const site = bareHost$1(new URL(start).host);
 	const sameSite = (url) => {
 		try {
-			return bareHost(new URL(url).host) === site;
+			return bareHost$1(new URL(url).host) === site;
 		} catch {
 			return false;
 		}
@@ -24083,15 +24169,15 @@ function internalLinksReportRange(input, fallbackDays, now) {
 		days: Math.round((Date.parse(`${endDate}T00:00:00Z`) - Date.parse(`${startDate}T00:00:00Z`)) / DAY$1) + 1
 	};
 }
-const plural$3 = (count, word) => `${count} ${word}${count === 1 ? "" : "s"}`;
+const plural$4 = (count, word) => `${count} ${word}${count === 1 ? "" : "s"}`;
 function internalLinksVerdict(report) {
 	const { counts } = report;
 	if (report.dataStatus === "blocked") return "robots.txt does not allow this crawler to read the site, so nothing was checked.";
 	if (report.dataStatus === "empty") return "No HTML page could be crawled, so there is nothing to link.";
 	if (report.dataStatus === "target-not-crawled") return "The target page could not be crawled as its own page (it failed, left the site, or names another page as canonical). Check it with seo page first.";
 	if (report.dataStatus === "target-not-linkable") return `The target is ${report.target?.noindex ? "noindex" : `a ${report.target?.type?.replaceAll("_", " ")} page`}, so no links to it are suggested.`;
-	const judged = report.judge.status === "used" || report.judge.status === "partial" ? `${counts.strong} strong and ${counts.possible} possible link${counts.strong + counts.possible === 1 ? "" : "s"} judged by ${report.judge.model}${counts.heuristic ? `, plus ${plural$3(counts.heuristic, "heuristic link")} where a request failed` : ""}` : `${plural$3(counts.heuristic, "heuristic link")} (no decision model)`;
-	const scope = report.mode === "url" ? `to ${report.target?.url}` : `across ${plural$3(counts.pagesCrawled, "page")}`;
+	const judged = report.judge.status === "used" || report.judge.status === "partial" ? `${counts.strong} strong and ${counts.possible} possible link${counts.strong + counts.possible === 1 ? "" : "s"} judged by ${report.judge.model}${counts.heuristic ? `, plus ${plural$4(counts.heuristic, "heuristic link")} where a request failed` : ""}` : `${plural$4(counts.heuristic, "heuristic link")} (no decision model)`;
+	const scope = report.mode === "url" ? `to ${report.target?.url}` : `across ${plural$4(counts.pagesCrawled, "page")}`;
 	const capped = report.crawl.capReached ? ` The crawl stopped at its limit of ${report.crawl.pageLimit} pages, so pages beyond it were not checked.` : "";
 	return `${judged} ${scope}${counts.heldBack ? `; ${counts.heldBack} held back by the evidence floors` : ""}.${capped}`;
 }
@@ -25992,7 +26078,7 @@ function reportId(input) {
 	})).digest("hex").slice(0, 20)}`;
 }
 function cacheGet(id, now) {
-	const row = getDb().prepare("SELECT report_json FROM performance_reports WHERE id = ? AND expires_at > ?").get(id, now);
+	const row = cacheDb().prepare("SELECT report_json FROM performance_reports WHERE id = ? AND expires_at > ?").get(id, now);
 	if (!row?.report_json) return void 0;
 	try {
 		const report = JSON.parse(row.report_json);
@@ -26007,10 +26093,12 @@ function cacheSet(report, now) {
 		raw: void 0
 	};
 	const reportJson = JSON.stringify(stored);
-	getDb().prepare(`INSERT OR REPLACE INTO performance_reports
-      (id, url, strategy, report_json, created_at, expires_at)
-      VALUES (?, ?, ?, ?, ?, ?)`).run(report.id, report.url, report.strategy, reportJson, Date.parse(report.generatedAt), now + CACHE_TTL_MS);
-	noteCacheWrite(Buffer.byteLength(reportJson));
+	writeToCache((database) => {
+		database.prepare(`INSERT OR REPLACE INTO performance_reports
+        (id, url, strategy, report_json, created_at, expires_at)
+        VALUES (?, ?, ?, ?, ?, ?)`).run(report.id, report.url, report.strategy, reportJson, Date.parse(report.generatedAt), now + CACHE_TTL_MS);
+		noteCacheWrite(Buffer.byteLength(reportJson), database);
+	});
 }
 async function fallbackReport(input) {
 	const fetched = await fetchPage(input.url, {
@@ -26530,14 +26618,14 @@ function* retainedQueryClusterRows(input) {
 		};
 	}
 }
-function plural$2(count, singular, pluralLabel = `${singular}s`) {
+function plural$3(count, singular, pluralLabel = `${singular}s`) {
 	return count === 1 ? singular : pluralLabel;
 }
 function reportVerdict(input) {
 	if (!input.clusters.length) return "No query clusters were generated for this scope.";
 	if (input.highOpportunityClusters > 0) {
 		const verb = input.highOpportunityClusters === 1 ? "has" : "have";
-		return `${input.highOpportunityClusters} ${plural$2(input.highOpportunityClusters, "cluster")} ${verb} enough demand and weak enough performance to review first.`;
+		return `${input.highOpportunityClusters} ${plural$3(input.highOpportunityClusters, "cluster")} ${verb} enough demand and weak enough performance to review first.`;
 	}
 	return "No obvious high-opportunity clusters were found. Use this report for content structure and intent mapping rather than urgent fixes.";
 }
@@ -26678,7 +26766,7 @@ function movementLine(report) {
 }
 function countPhrase(count, singular, pluralLabel = `${singular}s`) {
 	if (count === 0) return `no ${pluralLabel}`;
-	return `${count} ${plural$1(count, singular, pluralLabel)}`;
+	return `${count} ${plural$2(count, singular, pluralLabel)}`;
 }
 function headlineLine(report) {
 	const parts = [
@@ -26733,7 +26821,7 @@ function decayDiagnosisLabel(diagnosis) {
 	if (diagnosis === "lost_clicks") return "clicks dropped without one dominant signal";
 	return diagnosis.replaceAll("_", " ");
 }
-function plural$1(count, singular, pluralLabel = `${singular}s`) {
+function plural$2(count, singular, pluralLabel = `${singular}s`) {
 	return count === 1 ? singular : pluralLabel;
 }
 function decayClusterLine(report) {
@@ -26741,7 +26829,7 @@ function decayClusterLine(report) {
 	if (!group) return "No material decay cluster stood out.";
 	const diagnosis = decayDiagnosisLabel(group.diagnosis);
 	const samples = group.sampleQueries.slice(0, 2).join("; ");
-	return `Top decay cluster: ${group.count} ${plural$1(group.count, "finding")} in the ${group.template.label} template (${diagnosis}), ${group.totalClickLoss.toFixed(0)} fewer observed clicks across rows retained in both windows. Action: ${group.recommendation}${samples ? ` Example queries: ${samples}.` : ""}`;
+	return `Top decay cluster: ${group.count} ${plural$2(group.count, "finding")} in the ${group.template.label} template (${diagnosis}), ${group.totalClickLoss.toFixed(0)} fewer observed clicks across rows retained in both windows. Action: ${group.recommendation}${samples ? ` Example queries: ${samples}.` : ""}`;
 }
 function cannibalSuppressionLine(report) {
 	const suppressed = report.cannibalization.selection.suppressedQueries;
@@ -26759,21 +26847,21 @@ function contentOpportunityBullets(report) {
 	if (unavailableSections.length) bullets.push(`Could not assess ${unavailableSections.join(", ")} opportunities in this run; see report caveats.`);
 	if (report.summary.decayItems) {
 		const top = report.decay.items[0];
-		bullets.push(top ? `${report.summary.decayItems} observed retained query/page ${plural$1(report.summary.decayItems, "decline")} need review. Start with "${top.query}" on ${top.url}; it had ${top.clickLoss.toFixed(0)} fewer clicks.` : `${report.summary.decayItems} observed retained query/page ${plural$1(report.summary.decayItems, "decline")} need review.`);
+		bullets.push(top ? `${report.summary.decayItems} observed retained query/page ${plural$2(report.summary.decayItems, "decline")} need review. Start with "${top.query}" on ${top.url}; it had ${top.clickLoss.toFixed(0)} fewer clicks.` : `${report.summary.decayItems} observed retained query/page ${plural$2(report.summary.decayItems, "decline")} need review.`);
 		bullets.push(decayClusterLine(report));
 	}
 	if (report.summary.cannibalItems) {
 		const top = report.cannibalization.items[0];
-		bullets.push(top ? `${report.summary.cannibalItems} multi-URL query ${plural$1(report.summary.cannibalItems, "candidate")} need intent and technical review. Start with "${top.query}" and decide whether ${top.pages.length} ranking URLs answer the same intent.` : `${report.summary.cannibalItems} multi-URL query ${plural$1(report.summary.cannibalItems, "candidate")} need intent and technical review.`);
+		bullets.push(top ? `${report.summary.cannibalItems} multi-URL query ${plural$2(report.summary.cannibalItems, "candidate")} need intent and technical review. Start with "${top.query}" and decide whether ${top.pages.length} ranking URLs answer the same intent.` : `${report.summary.cannibalItems} multi-URL query ${plural$2(report.summary.cannibalItems, "candidate")} need intent and technical review.`);
 	}
 	if (report.cannibalization.selection.suppressedQueries) bullets.push(cannibalSuppressionLine(report));
 	if (report.summary.strikingDistanceItems) {
 		const top = report.strikingDistance.items[0];
-		bullets.push(top ? `${countLabel(report.summary.strikingDistanceItems, "query/page candidate")} ${plural$1(report.summary.strikingDistanceItems, "has", "have")} an average GSC position above 10 and at most 20. Start by investigating "${top.query}" on ${top.url}; it averages position ${top.position.toFixed(1)} with ${top.impressions.toFixed(0)} impressions.` : `${countLabel(report.summary.strikingDistanceItems, "query/page candidate")} ${plural$1(report.summary.strikingDistanceItems, "has", "have")} an average GSC position above 10 and at most 20.`);
+		bullets.push(top ? `${countLabel(report.summary.strikingDistanceItems, "query/page candidate")} ${plural$2(report.summary.strikingDistanceItems, "has", "have")} an average GSC position above 10 and at most 20. Start by investigating "${top.query}" on ${top.url}; it averages position ${top.position.toFixed(1)} with ${top.impressions.toFixed(0)} impressions.` : `${countLabel(report.summary.strikingDistanceItems, "query/page candidate")} ${plural$2(report.summary.strikingDistanceItems, "has", "have")} an average GSC position above 10 and at most 20.`);
 	}
 	if (!skippedReason(report, "quick-win opportunities") && report.summary.quickWinItems) {
 		const top = report.quickWins.items[0];
-		bullets.push(top ? `${report.summary.quickWinItems} retained query/page ${plural$1(report.summary.quickWinItems, "candidate")} fell below a site-peer or versioned heuristic CTR target. Start with "${top.query}" on ${top.url}; it had ${top.impressions.toFixed(0)} impressions at average position ${top.position.toFixed(1)}.` : `${report.summary.quickWinItems} CTR-target ${plural$1(report.summary.quickWinItems, "candidate")} need review.`);
+		bullets.push(top ? `${report.summary.quickWinItems} retained query/page ${plural$2(report.summary.quickWinItems, "candidate")} fell below a site-peer or versioned heuristic CTR target. Start with "${top.query}" on ${top.url}; it had ${top.impressions.toFixed(0)} impressions at average position ${top.position.toFixed(1)}.` : `${report.summary.quickWinItems} CTR-target ${plural$2(report.summary.quickWinItems, "candidate")} need review.`);
 	}
 	const templateLine = templateOpportunityLine(report);
 	if (!templateLine.startsWith("No dominant")) bullets.push(templateLine);
@@ -28495,11 +28583,12 @@ function ga4MatchReason(match, site) {
 //#endregion
 //#region packages/core/src/commands/clicky.ts
 const CLICKY_KEY_PREFIX = "x-clicky-";
+const MAX_INSPECT_LIMIT = 2e3;
 //#endregion
 //#region packages/core/src/commands/page-facts.ts
 const MAX_PAGES = 20;
-const TIMEOUT_MS = 6e3;
-const MAX_BYTES = 1e6;
+const TIMEOUT_MS$2 = 6e3;
+const MAX_BYTES$2 = 1e6;
 const clean = (value) => value?.trim().replace(/\s+/g, " ") || null;
 async function boundedText(response) {
 	if (!response.body) return "";
@@ -28507,7 +28596,7 @@ async function boundedText(response) {
 	const decoder = new TextDecoder();
 	let text = "";
 	let total = 0;
-	while (total < MAX_BYTES) {
+	while (total < MAX_BYTES$2) {
 		const { done, value } = await reader.read();
 		if (done) return text + decoder.decode();
 		total += value.byteLength;
@@ -28587,12 +28676,14 @@ async function facts(url) {
 				"user-agent": SEO_CRAWLER_USER_AGENT,
 				accept: "text/html"
 			},
-			signal: AbortSignal.timeout(TIMEOUT_MS)
+			signal: AbortSignal.timeout(TIMEOUT_MS$2)
 		});
 		out.status = response.status;
 		const location = response.headers.get("location");
 		if (location) out.redirects_to = new URL(location, url).toString();
 		const headerRobots = response.headers.get("x-robots-tag");
+		const auth = response.headers.get("www-authenticate");
+		if (auth) out.www_authenticate = auth.slice(0, 200);
 		if (response.status !== 200 || !response.headers.get("content-type")?.includes("html")) {
 			out.robots = headerRobots;
 			await response.body?.cancel();
@@ -28609,6 +28700,37 @@ async function facts(url) {
 function checkPages(urls) {
 	return Promise.all(urls.slice(0, MAX_PAGES).map(facts));
 }
+const MAX_HOPS = 5;
+const redirectKind = (status) => status === 301 || status === 308 ? "permanent" : status === 302 || status === 303 || status === 307 ? "temporary" : null;
+async function liveCheck(url) {
+	const first = await facts(url);
+	const hops = [];
+	const seen = /* @__PURE__ */ new Set([url]);
+	let last = first;
+	while (last.redirects_to && last.status !== null) {
+		const kind = redirectKind(last.status);
+		if (!kind) break;
+		const to = last.redirects_to;
+		hops.push({
+			from: last.url,
+			status: last.status,
+			to,
+			kind
+		});
+		if (seen.has(to) || hops.length > MAX_HOPS) return {
+			first,
+			hops,
+			last: null
+		};
+		seen.add(to);
+		last = await facts(to);
+	}
+	return {
+		first,
+		hops,
+		last
+	};
+}
 //#endregion
 //#region packages/core/src/commands/report.ts
 const SECTIONS = {
@@ -28641,16 +28763,23 @@ const RESEARCH_HELP = `keyword_metrics (keywords: volume, difficulty, CPC), rank
 function indexStatusFrom(result) {
 	const status = result?.inspectionResult?.indexStatusResult ?? result?.indexStatusResult ?? {};
 	const text = (value) => typeof value === "string" ? value : null;
+	const list = (value) => Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
 	return {
 		verdict: text(status.verdict),
 		coverage: text(status.coverageState),
 		indexing: text(status.indexingState),
 		last_crawl: text(status.lastCrawlTime),
 		google_canonical: text(status.googleCanonical),
-		user_canonical: text(status.userCanonical)
+		user_canonical: text(status.userCanonical),
+		page_fetch: text(status.pageFetchState),
+		robots_txt: text(status.robotsTxtState),
+		crawled_as: text(status.crawledAs),
+		referring_urls: list(status.referringUrls),
+		sitemaps: list(status.sitemap)
 	};
 }
 const LOST_PAGES_RULE = `Pages that had at least 3 clicks in the previous 28 days and kept ${.2 * 100}% or less of them in the last 28 days, with a live check of the top 20 and Google’s index status for the top 10 and the home page.`;
+const INDEXING_RULE = `Google’s indexing reasons for 100 known URLs a run in a fixed order (lost-click pages, Search Console pages by clicks then impressions, sitemap URLs, then the rest), each checked live and labelled fix, check, expected or indexed from the evidence, sorted by reason then URL.`;
 //#endregion
 //#region packages/core/src/commands/tools.ts
 const site = z.string().min(1).describe("Search Console property or site, such as sc-domain:example.com, https://example.com/ or example.com.");
@@ -28685,9 +28814,15 @@ z.object({}), `${Object.entries(SECTIONS).map(([id, text]) => `- ${id}: ${text}`
 	site,
 	date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).describe("YYYY-MM-DD: the first day after the change."),
 	pages: z.string().min(1).optional().describe("Optional URL text, such as /blog/.")
-}), `${LOST_PAGES_RULE}`, z.object({
+}), `${INDEXING_RULE}${LOST_PAGES_RULE}`, z.object({
 	site,
-	...dates
+	...dates,
+	...detail
+}), z.object({
+	site,
+	...dates,
+	max_urls: z.number().int().min(1).max(MAX_INSPECT_LIMIT).optional().describe(`URLs to inspect with Google, 100 by default, up to the URL Inspection quota left today.`),
+	...detail
 }), `${RESEARCH_HELP}`, z.object({
 	provider: z.enum(RESEARCH_PROVIDERS),
 	action: z.enum(RESEARCH_ACTIONS),
@@ -28705,6 +28840,36 @@ z.object({}), `${Object.entries(SECTIONS).map(([id, text]) => `- ${id}: ${text}`
 	...detail
 });
 //#endregion
+//#region packages/core/src/gsc/client/inspection-cache.ts
+const INSPECTION_FRESH_MS = 7 * 864e5;
+function readSavedInspections(site, urls, now = Date.now()) {
+	const found = /* @__PURE__ */ new Map();
+	try {
+		const statement = cacheDb().prepare(`SELECT status_json, fetched_at FROM url_inspection_cache
+      WHERE site_url = ? AND url = ? AND fetched_at > ?`);
+		for (const url of urls) {
+			const row = statement.get(site, url, now - INSPECTION_FRESH_MS);
+			if (!row) continue;
+			found.set(url, {
+				status: JSON.parse(row.status_json),
+				inspectedAt: new Date(row.fetched_at).toISOString()
+			});
+		}
+	} catch {
+		return /* @__PURE__ */ new Map();
+	}
+	return found;
+}
+function saveInspection(site, url, status, now = Date.now()) {
+	const json = JSON.stringify(status);
+	writeToCache((database) => {
+		database.prepare(`INSERT OR REPLACE INTO url_inspection_cache
+        (site_url, url, status_json, fetched_at, expires_at)
+        VALUES (?, ?, ?, ?, ?)`).run(site, url, json, now, now + INSPECTION_FRESH_MS);
+		noteCacheWrite(Buffer.byteLength(json) + url.length, database);
+	});
+}
+//#endregion
 //#region packages/core/src/providers/api-key-credentials.ts
 function createApiKeyCredentialStore(input) {
 	const normalize = (value) => {
@@ -28900,16 +29065,19 @@ function nodeCommandDeps(options) {
 			accountEmail: options.account
 		}),
 		checkPages,
-		inspect: async (site, url) => {
-			try {
-				return indexStatusFrom(await inspectUrl({
-					siteUrl: site,
-					inspectionUrl: url,
-					accountEmail: options.account
-				}));
-			} catch {
-				return null;
-			}
+		liveCheck,
+		inspect: async (site, url) => indexStatusFrom(await inspectUrl({
+			siteUrl: site,
+			inspectionUrl: url,
+			accountEmail: options.account
+		})),
+		inspectionQuota: (site) => urlInspectionQuota({
+			siteUrl: site,
+			accountEmail: options.account
+		}),
+		savedInspections: {
+			read: (site, urls) => options.refresh ? /* @__PURE__ */ new Map() : readSavedInspections(site, urls),
+			save: saveInspection
 		},
 		pageMarkdown: async (url) => extractMainMarkdown(await fetchPage(url, { refresh: options.refresh })),
 		call: options.call,
@@ -30564,6 +30732,94 @@ async function resetSeoData() {
 	});
 }
 //#endregion
+//#region packages/core/src/update-notice.ts
+const REGISTRY_URL = "https://registry.npmjs.org/seo/latest";
+const CHECK_EVERY_MS = 864e5;
+const TIMEOUT_MS = 2e3;
+const MAX_BYTES = 65536;
+let checking = false;
+function runByNpx(env, cliPath) {
+	if (env.npm_command === "exec" || /npx/i.test(env.npm_execpath ?? "")) return true;
+	if (!cliPath) return false;
+	let path = cliPath;
+	try {
+		path = realpathSync(cliPath);
+	} catch {}
+	return /[\\/](?:_npx|dlx)[\\/]/.test(path);
+}
+function isNewerVersion(current, latest) {
+	const parse = (value) => value.replace(/^v/, "").split("-")[0]?.split(".").map((part) => Number.parseInt(part, 10)) ?? [];
+	const currentParts = parse(current);
+	const latestParts = parse(latest);
+	for (let index = 0; index < 3; index += 1) {
+		const currentPart = currentParts[index] ?? 0;
+		const latestPart = latestParts[index] ?? 0;
+		if (!Number.isFinite(currentPart) || !Number.isFinite(latestPart)) return false;
+		if (latestPart > currentPart) return true;
+		if (latestPart < currentPart) return false;
+	}
+	return false;
+}
+function isLatestCache(value) {
+	if (!value || typeof value !== "object") return false;
+	const cache = value;
+	return typeof cache.checkedAt === "number" && typeof cache.latest === "string" && /^\d+\.\d+\.\d+$/.test(cache.latest);
+}
+function checkRegistry(cacheFile, now) {
+	if (checking) return;
+	checking = true;
+	const done = () => {
+		checking = false;
+	};
+	const req = request(REGISTRY_URL, { headers: { accept: "application/json" } });
+	const timer = setTimeout(() => req.destroy(), TIMEOUT_MS);
+	timer.unref();
+	req.on("socket", (socket) => socket.unref());
+	req.on("error", () => void 0);
+	req.on("close", () => {
+		clearTimeout(timer);
+		done();
+	});
+	req.on("response", (response) => {
+		const chunks = [];
+		let size = 0;
+		response.on("error", () => void 0);
+		response.on("data", (chunk) => {
+			size += chunk.length;
+			if (size > MAX_BYTES) req.destroy();
+			else chunks.push(chunk);
+		});
+		response.on("end", () => {
+			if (response.statusCode !== 200 || size > MAX_BYTES) return;
+			readJson(new Response(Buffer.concat(chunks)), "The npm registry").then((body) => {
+				const cache = {
+					checkedAt: now,
+					latest: body.version
+				};
+				if (isLatestCache(cache)) writeJsonAtomic(cacheFile, cache, 384);
+			}).catch(() => void 0);
+		});
+	});
+	req.end();
+}
+function updateNotice(options = {}) {
+	try {
+		const env = options.env ?? process.env;
+		const argv = options.argv ?? process.argv;
+		if (env.NO_UPDATE_NOTIFIER || argv.includes("--no-update-notifier") || isTelemetryCi(env)) return;
+		const cacheFile = options.cacheFile ?? join(getSeoCliPaths().cacheDir, "latest-version.json");
+		const now = (options.now ?? /* @__PURE__ */ new Date()).getTime();
+		const stored = readJsonFile(cacheFile);
+		const cache = isLatestCache(stored) ? stored : void 0;
+		if (!cache || now - cache.checkedAt >= CHECK_EVERY_MS) checkRegistry(cacheFile, now);
+		const current = options.version ?? SEO_VERSION;
+		if (!cache || !isNewerVersion(current, cache.latest)) return void 0;
+		return runByNpx(env, options.cliPath ?? argv[1]) ? `seo ${cache.latest} is out (you have ${current}). Run npx -y seo@latest; in an MCP config use seo@latest, then restart the client.` : `seo ${cache.latest} is out (you have ${current}). Update with: npm i -g seo`;
+	} catch {
+		return;
+	}
+}
+//#endregion
 //#region packages/core/src/utils/time.ts
 function parseOlderThan(input) {
 	if (!input) return;
@@ -30598,6 +30854,6 @@ function isoDate(daysAgo = 0) {
 	return date.toISOString().slice(0, 10);
 }
 //#endregion
-export { AHREFS_API_KEY_ENV, AHREFS_API_KEY_SECRET, AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, ANALYTICS_PROVIDER_IDS, AUDIT_PAGE_RULE_IDS, AhrefsClient, BING_API_KEY_ENV, BING_API_KEY_SECRET, BROWSER_USER_AGENT, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CLICKY_SITEKEY_ENV, CLICKY_SITE_KEYS_SECRET, CLOUD_SIGN_IN, CLOUD_URL, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DATAFORSEO_CREDENTIAL_SECRET, DATAFORSEO_LOGIN_ENV, DATAFORSEO_PASSWORD_ENV, DEFAULT_MAX_PAGES, DEFAULT_SEARCH_CONSOLE_EXPORT_ROW_LIMIT, DEFAULT_UNREACHED_PAGE_LIMIT, DataForSeoClient, DecisionModelError, DecisionRunner, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, GoogleApiError, INCIDENTS_URL, JsonFileStorageAdapter, LINK_ROLES, LOCAL_BING_CONNECT, LOCAL_SIGN_IN, LOG_MAX_AGE_MS, LOG_MAX_FILE_BYTES, LOG_MAX_TOTAL_BYTES, LocalCredentialsProvider, MANAGED_PROVIDER_SECRET_NAMES, MAX_CRAWL_CONCURRENCY, MAX_CRAWL_DEPTH, MAX_CRAWL_PAGES, MAX_CRAWL_TIMEOUT_MS, MAX_MAX_PAGES, MAX_SEARCH_CONSOLE_EXPORT_FILES, MAX_SEARCH_CONSOLE_EXPORT_ROW_LIMIT, PAGE_TYPES, PROVIDER_SECRET_NAMES, ProviderError, ProviderExtensionRegistry, RESEARCH_IMPORT_COLUMN_KEYS, ResponseSizeLimitError, SEARCH_INTENTS, SEO_CRAWLER_IDENTITY, SEO_CRAWLER_TOKEN, SEO_CRAWLER_USER_AGENT, SEO_PROVIDER_API_VERSION, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, STEP_CHANGE_RULES, SeoError, ServiceAccountAccessTokenClient, SessionLedger, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_FAILURE_CONTEXTS, TELEMETRY_FAILURE_REASONS, TELEMETRY_NOTICE, TELEMETRY_OPERATIONS, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, TYPESAFE_API_KEY_ENV, agentActionsView, aiReferralSourceForValue, aiReferralsReport, analyticsConnectionLabel, analyticsConnectionProviderId, analyticsConnectionSchema, analyticsProviderDetails, analyticsProviderSchema, analyzeAiReferralRows, analyzeCannibalImportRows, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertCrawlConfigLimits, assertUrlMatchesGscProperty, auditCrawlPages, auditCrawlRequests, auditPage, authStatus, bearerFetch, boundedSitemapInventory, buildAgentFindings, buildQueryClusterReportFromRows, buildTelemetryPayload, cannibalImportReport, cannibalReport, cannibalReportWith, changeWindow, checkDatabaseReadiness, classifyTelemetryFailure, clearCache, cloudAccountFor, cloudBing, cloudCredentials, cloudGoogleEmails, cloudGoogleToken, cloudKeys, cloudLinked, cloudLogout, clusterQueryRows, combineRobotsValues, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlStatusOnly, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createLogger, createPageRenderer, ctrUnderperformersReport, ctrUnderperformersReportWith, decayClusterDrafts, decayComparisonRange, decayingReport, decayingReportWith, deleteAhrefsApiKey, deleteBingApiKey, deleteClickySiteKey, deleteDataForSeoCredentials, deleteManagedProviderSecrets, deleteProviderExtensionAccount, deleteProviderExtensionCredentials, deleteProviderSecret, deleteTokens, deriveBrandTerms, describeInstalledProviderExtension, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, ensurePrivateDatabaseFiles, ensureSeoCliDirs, estimateSerpTitleWidth, expectedCtrForPosition, explainRule, fetchCruxFieldData, fetchPage, fetchPageStatus, fetchSearchStatusIncidents, fetchSitemapUrls, fileSize, finalGscDateRange, findOverlappingSearchUpdates, finishCloudLogin, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, getAuthModeStatus, getCacheStats, getClientConfig, getDb, getPrivacySnapshot, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleJson, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, indexCoverageSignals, inferTemplateMovement, initializeTelemetry, inspectProviderPackage, inspectSearchConsoleUrl, inspectUrl, installProviderPackage, installedProviderPackageSchema, installedProviderPackagesSchema, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isSkippableReportError, isTelemetryCi, isTelemetryOperation, isTelemetryReport, isoDate, isoWeek, latestFinalGscDate, linkRecover, linkRecoverRecommendation, listAnalyticsAccounts, listAnalyticsDataStreams, listGa4AccountSummaries, listGa4DataStreams, listGoogleAccounts, listInstalledProviderExtensions, listRules, listSearchConsoleSites, listSearchUpdates, listSites, loadInstalledProviderExtensions, loadProviderExtensions, loadProviderPackage, loadSearchConsoleExport, localAccounts, localBing, localCredentialsProvider, localError, localGoogleFetch, localInternalLinksDependencies, localRefreshClicky, localResearchKeys, loginWithLoopback, makeRunId, matchGa4WebStreams, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, nodeCommandDeps, normalizeBrandText, normalizeClickySiteId, normalizeClickySiteKey, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLoadedCrawlReport, normalizeProviderExtensionAccount, normalizedResearchColumnName, notSignedIn, noteCacheWrite, openCloudLink, pageEvidenceRecommendation, pageOpportunitiesReport, parseOlderThan, pendingCloudLogin, performanceAudit, performanceReportIsCacheable, plural, providerCapabilitySchema, providerConnectionFieldSchema, providerExactVersionSchema, providerExtensionIdSchema, providerIdSchema, providerIntegritySchema, providerKindSchema, providerPackageManifestSchema, providerPackageNameSchema, providerPreferenceSchema, providerRegistrationSchema, providerRequestJson, providerRequestText, pruneLogs, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, quickWinsReportWith, readAhrefsApiKey, readAllTokens, readBingApiKey, readBoundedResponseText, readClickySiteKey, readClickySiteKeys, readConfig, readDataForSeoCredentials, readInstalledProviderPackages, readJson, readJsonOrUndefined, readOauthClient, readProviderExtensionAccount, readProviderExtensionCredentials, readProviderSecret, readTokens, recommendationForRule, reconcileExportPagesWithCrawl, redirectTrace, refreshAuthToken, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, registrableDomain, removeInstalledProviderPackage, renderCrawlCsv, renderCrawlHtml, renderCrawlJunit, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderWorkflowMarkdown, reportNarrative, requestHeaders, requirePageVerification, researchImportColumns, resetSeoData, resolveLocalSite, resolveSegmentRanges, resolveSeoCliPaths, reviewObservations, roundedPosition, runAnalyticsProviderLandingPages, runAnalyticsReport, runDoctor, runGa4Report, runProviderExtensionAction, runtimeForProvider, safeProviderAdapterError, saveInstalledProviderPackage, searchAnalyticsRows, searchUpdatesFromIncidents, secondPage, secondPageWith, segmentComparisonRange, segmentImpact, segmentRangeDays, seoErrorEnvelope, sessionSourceInListFilter, setActiveGoogleAccount, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteStartUrl, startCloudLogin, strikingDistance, strikingDistanceWith, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, telemetryErrorCategory, toSeoError, tokenSchema, tokenStoreSchema, topFixes, trackTelemetryCommandFailed, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, trafficAnomalyWith, typesafeDecisionModel, unavailableSegmentImpactReport, unicodeTokens, uninstallProviderExtension, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateResearchImportColumnSources, verifyAnalyticsProvider, verifyProviderExtension, verifyQueryContent, verifyQueryContentWith, withAgentReportContract, withRankingHistory, workflowPresentation, writeAhrefsApiKey, writeBingApiKey, writeClickySiteKey, writeConfig, writeDataForSeoCredentials, writeInstalledProviderPackages, writeOauthClient, writeProviderExtensionAccount, writeProviderExtensionCredentials, writeProviderSecret, writeTokens, xRobotsDirectives };
+export { AHREFS_API_KEY_ENV, AHREFS_API_KEY_SECRET, AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, ANALYTICS_PROVIDER_IDS, AUDIT_PAGE_RULE_IDS, AhrefsClient, BING_API_KEY_ENV, BING_API_KEY_SECRET, BROWSER_USER_AGENT, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CLICKY_SITEKEY_ENV, CLICKY_SITE_KEYS_SECRET, CLOUD_SIGN_IN, CLOUD_URL, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DATAFORSEO_CREDENTIAL_SECRET, DATAFORSEO_LOGIN_ENV, DATAFORSEO_PASSWORD_ENV, DEFAULT_MAX_PAGES, DEFAULT_SEARCH_CONSOLE_EXPORT_ROW_LIMIT, DEFAULT_UNREACHED_PAGE_LIMIT, DataForSeoClient, DecisionModelError, DecisionRunner, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, GoogleApiError, INCIDENTS_URL, JsonFileStorageAdapter, LINK_ROLES, LOCAL_BING_CONNECT, LOCAL_SIGN_IN, LOG_MAX_AGE_MS, LOG_MAX_FILE_BYTES, LOG_MAX_TOTAL_BYTES, LocalCredentialsProvider, MANAGED_PROVIDER_SECRET_NAMES, MAX_CRAWL_CONCURRENCY, MAX_CRAWL_DEPTH, MAX_CRAWL_PAGES, MAX_CRAWL_TIMEOUT_MS, MAX_MAX_PAGES, MAX_SEARCH_CONSOLE_EXPORT_FILES, MAX_SEARCH_CONSOLE_EXPORT_ROW_LIMIT, PAGE_TYPES, PROVIDER_SECRET_NAMES, ProviderError, ProviderExtensionRegistry, RESEARCH_IMPORT_COLUMN_KEYS, ResponseSizeLimitError, SEARCH_INTENTS, SEO_CRAWLER_IDENTITY, SEO_CRAWLER_TOKEN, SEO_CRAWLER_USER_AGENT, SEO_PROVIDER_API_VERSION, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, STEP_CHANGE_RULES, SeoError, ServiceAccountAccessTokenClient, SessionLedger, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_FAILURE_CONTEXTS, TELEMETRY_FAILURE_REASONS, TELEMETRY_NOTICE, TELEMETRY_OPERATIONS, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, TYPESAFE_API_KEY_ENV, agentActionsView, aiReferralSourceForValue, aiReferralsReport, analyticsConnectionLabel, analyticsConnectionProviderId, analyticsConnectionSchema, analyticsProviderDetails, analyticsProviderSchema, analyzeAiReferralRows, analyzeCannibalImportRows, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertCrawlConfigLimits, assertUrlMatchesGscProperty, auditCrawlPages, auditCrawlRequests, auditPage, authStatus, bearerFetch, boundedSitemapInventory, buildAgentFindings, buildQueryClusterReportFromRows, buildTelemetryPayload, cacheDb, cannibalImportReport, cannibalReport, cannibalReportWith, changeWindow, checkDatabaseReadiness, classifyTelemetryFailure, clearCache, cloudAccountFor, cloudBing, cloudCredentials, cloudGoogleEmails, cloudGoogleToken, cloudKeys, cloudLinked, cloudLogout, clusterQueryRows, combineRobotsValues, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlStatusOnly, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createLogger, createPageRenderer, ctrUnderperformersReport, ctrUnderperformersReportWith, decayClusterDrafts, decayComparisonRange, decayingReport, decayingReportWith, deleteAhrefsApiKey, deleteBingApiKey, deleteClickySiteKey, deleteDataForSeoCredentials, deleteManagedProviderSecrets, deleteProviderExtensionAccount, deleteProviderExtensionCredentials, deleteProviderSecret, deleteTokens, deriveBrandTerms, describeInstalledProviderExtension, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, ensurePrivateDatabaseFiles, ensureSeoCliDirs, estimateSerpTitleWidth, expectedCtrForPosition, explainRule, fetchCruxFieldData, fetchPage, fetchPageStatus, fetchSearchStatusIncidents, fetchSitemapUrls, fileSize, finalGscDateRange, findOverlappingSearchUpdates, finishCloudLogin, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, getAuthModeStatus, getCacheStats, getClientConfig, getDb, getPrivacySnapshot, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleJson, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, indexCoverageSignals, inferTemplateMovement, initializeTelemetry, inspectProviderPackage, inspectSearchConsoleUrl, inspectUrl, installProviderPackage, installedProviderPackageSchema, installedProviderPackagesSchema, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isNewerVersion, isSkippableReportError, isTelemetryCi, isTelemetryOperation, isTelemetryReport, isoDate, isoWeek, latestFinalGscDate, linkRecover, linkRecoverRecommendation, listAnalyticsAccounts, listAnalyticsDataStreams, listGa4AccountSummaries, listGa4DataStreams, listGoogleAccounts, listInstalledProviderExtensions, listRules, listSearchConsoleSites, listSearchUpdates, listSites, loadInstalledProviderExtensions, loadProviderExtensions, loadProviderPackage, loadSearchConsoleExport, localAccounts, localBing, localCredentialsProvider, localError, localGoogleFetch, localInternalLinksDependencies, localRefreshClicky, localResearchKeys, loginWithLoopback, makeRunId, matchGa4WebStreams, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, nodeCommandDeps, normalizeBrandText, normalizeClickySiteId, normalizeClickySiteKey, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLoadedCrawlReport, normalizeProviderExtensionAccount, normalizedResearchColumnName, notSignedIn, noteCacheWrite, openCloudLink, pageEvidenceRecommendation, pageOpportunitiesReport, parseOlderThan, pendingCloudLogin, performanceAudit, performanceReportIsCacheable, plural, providerCapabilitySchema, providerConnectionFieldSchema, providerExactVersionSchema, providerExtensionIdSchema, providerIdSchema, providerIntegritySchema, providerKindSchema, providerPackageManifestSchema, providerPackageNameSchema, providerPreferenceSchema, providerRegistrationSchema, providerRequestJson, providerRequestText, pruneLogs, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, quickWinsReportWith, readAhrefsApiKey, readAllTokens, readBingApiKey, readBoundedResponseText, readClickySiteKey, readClickySiteKeys, readConfig, readDataForSeoCredentials, readInstalledProviderPackages, readJson, readJsonOrUndefined, readOauthClient, readProviderExtensionAccount, readProviderExtensionCredentials, readProviderSecret, readTokens, recommendationForRule, reconcileExportPagesWithCrawl, redirectTrace, refreshAuthToken, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, registrableDomain, removeInstalledProviderPackage, renderCrawlCsv, renderCrawlHtml, renderCrawlJunit, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderWorkflowMarkdown, reportNarrative, requestHeaders, requirePageVerification, researchImportColumns, resetSeoData, resolveLocalSite, resolveSegmentRanges, resolveSeoCliPaths, reviewObservations, roundedPosition, runAnalyticsProviderLandingPages, runAnalyticsReport, runDoctor, runGa4Report, runProviderExtensionAction, runtimeForProvider, safeProviderAdapterError, saveInstalledProviderPackage, searchAnalyticsRows, searchUpdatesFromIncidents, secondPage, secondPageWith, segmentComparisonRange, segmentImpact, segmentRangeDays, seoErrorEnvelope, sessionSourceInListFilter, setActiveGoogleAccount, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteStartUrl, startCloudLogin, strikingDistance, strikingDistanceWith, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, telemetryErrorCategory, toSeoError, tokenSchema, tokenStoreSchema, topFixes, trackTelemetryCommandFailed, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, trafficAnomalyWith, typesafeDecisionModel, unavailableSegmentImpactReport, unicodeTokens, uninstallProviderExtension, updateCorrelation, updateNotice, updatePostmortemCsvFiles, updatePostmortemWorkflow, urlInspectionQuota, validateResearchImportColumnSources, verifyAnalyticsProvider, verifyProviderExtension, verifyQueryContent, verifyQueryContentWith, withAgentReportContract, withRankingHistory, workflowPresentation, writeAhrefsApiKey, writeBingApiKey, writeClickySiteKey, writeConfig, writeDataForSeoCredentials, writeInstalledProviderPackages, writeOauthClient, writeProviderExtensionAccount, writeProviderExtensionCredentials, writeProviderSecret, writeToCache, writeTokens, xRobotsDirectives };
 
 //# sourceMappingURL=index.js.map