seo 0.10.0 → 0.11.0

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { i as __toESM, n as version, r as __commonJSMin, t as load } from "./esm-CM7xTOjT.js";
+import { i as __toESM, n as version, r as __commonJSMin, t as load } from "./esm-ZQwQYL0U.js";
 import { createHash, randomUUID, sign } from "node:crypto";
 import { ZodOptional, z } from "zod";
 import { arch, homedir, platform, tmpdir, totalmem } from "node:os";
@@ -26,6 +26,7 @@ import { TextDecoder as TextDecoder$1, promisify } from "node:util";
 import { execFile } from "node:child_process";
 import "pino";
 import "pino-pretty";
+import { request } from "node:https";
 import * as z3rt from "zod/v3";
 import { ZodFirstPartyTypeKind } from "zod/v3";
 import * as z4mini from "zod/v4-mini";
@@ -13877,7 +13878,7 @@ async function runAnalyticsReport(gfetch, propertyId, body, options) {
 //#endregion
 //#region packages/core/dist/bing/api.js
 const BASE = "https://ssl.bing.com/webmaster/api.svc/json";
-const MAX_BYTES$2 = 8e6;
+const MAX_BYTES$3 = 8e6;
 function bingCall(auth, options) {
 	return async (method, params = {}) => {
 		const url = new URL(`${BASE}/${method}`);
@@ -13902,7 +13903,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$3 })).d;
 	};
 }
 function day(value) {
@@ -16763,10 +16764,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;
@@ -16777,12 +16780,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,
@@ -16810,7 +16842,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,
@@ -16823,10 +16855,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;
 }
@@ -19198,7 +19232,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,
@@ -19217,12 +19251,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,
@@ -19329,7 +19363,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, {
@@ -19337,7 +19370,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 {
@@ -19439,12 +19472,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
@@ -20302,7 +20335,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,
@@ -20322,10 +20355,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,
@@ -20461,8 +20496,10 @@ async function queryPagesTopQueriesBatch(site, pageUrls, range = 28) {
 //#region packages/core/dist/gsc/client/sites.js
 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() {
@@ -26587,7 +26624,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,
@@ -26608,9 +26645,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;
 	}
 }
@@ -26621,19 +26660,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(),
@@ -27256,7 +27298,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$2 = 15e3;
 function normalizeProviderExtensionAccount(provider, account) {
 	const fields = provider.connection.fields.filter((field) => field.kind === "account");
 	const allowed = new Set(fields.map((field) => field.id));
@@ -27303,7 +27345,7 @@ function runtimeForProvider(provider, options = {}) {
 				},
 				fetch: providerFetch,
 				maxResponseBytes: MAX_RESPONSE_BYTES$1,
-				timeoutMs: TIMEOUT_MS$1,
+				timeoutMs: TIMEOUT_MS$2,
 				retry: (input.method ?? "GET") === "GET" ? "safe" : "never",
 				schema: z.unknown()
 			});
@@ -36851,7 +36893,7 @@ function reportId$1(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);
@@ -36866,10 +36908,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, {
@@ -39053,7 +39097,7 @@ async function updatePostmortemWorkflow(input, dependencies = {}) {
 //#endregion
 //#region packages/core/dist/clicky/api.js
 const ENDPOINT$1 = "https://api.clicky.com/api/stats/4";
-const MAX_BYTES$1 = 5e6;
+const MAX_BYTES$2 = 5e6;
 var ClickyError = class extends Error {
 	code;
 	constructor(code, message) {
@@ -39080,7 +39124,7 @@ async function clickyStats(site, types, options = {}) {
 		throw new ClickyError("remote", "Could not reach Clicky. Try again.");
 	});
 	if (!response.ok) throw new ClickyError("remote", `Clicky returned ${response.status}.`);
-	const groups = await readJson(response, "Clicky", { maxBytes: MAX_BYTES$1 });
+	const groups = await readJson(response, "Clicky", { maxBytes: MAX_BYTES$2 });
 	if (!Array.isArray(groups)) throw new ClickyError("remote", "Clicky returned invalid data.");
 	const failed = groups.find((group) => typeof group?.error === "string");
 	if (failed?.error) throw /sitekey|site id|authenticat|permission/iu.test(failed.error) ? new ClickyError("auth", `Clicky rejected site ID ${site.siteId} or its sitekey.`) : new ClickyError("remote", `Clicky: ${failed.error.slice(0, 200)}`);
@@ -40897,8 +40941,8 @@ function internalLinksText(report, options) {
 //#endregion
 //#region packages/core/dist/commands/page-facts.js
 const MAX_PAGES = 20;
-const TIMEOUT_MS = 6e3;
-const MAX_BYTES = 1e6;
+const TIMEOUT_MS$1 = 6e3;
+const MAX_BYTES$1 = 1e6;
 const clean = (value) => value?.trim().replace(/\s+/g, " ") || null;
 async function boundedText(response) {
 	if (!response.body) return "";
@@ -40906,7 +40950,7 @@ async function boundedText(response) {
 	const decoder = new TextDecoder();
 	let text = "";
 	let total = 0;
-	while (total < MAX_BYTES) {
+	while (total < MAX_BYTES$1) {
 		const { done, value } = await reader.read();
 		if (done) return text + decoder.decode();
 		total += value.byteLength;
@@ -40986,7 +41030,7 @@ async function facts(url) {
 				"user-agent": SEO_CRAWLER_USER_AGENT,
 				accept: "text/html"
 			},
-			signal: AbortSignal.timeout(TIMEOUT_MS)
+			signal: AbortSignal.timeout(TIMEOUT_MS$1)
 		});
 		out.status = response.status;
 		const location = response.headers.get("location");
@@ -42759,6 +42803,94 @@ var LocalCredentialsProvider = class {
 };
 new LocalCredentialsProvider();
 //#endregion
+//#region packages/core/dist/update-notice.js
+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/mcp/src/agent-output-budget.ts
 const AGENT_STRUCTURED_OUTPUT_MAX_BYTES = 96 * 1024;
 function jsonBytes(value) {
@@ -45305,7 +45437,7 @@ function text(value) {
 		text: value
 	}] };
 }
-async function counted(command, args, telemetry, run) {
+async function countedRun(command, args, telemetry, run) {
 	const report = telemetry ? telemetryReportFor(command, {
 		section: typeof args.section === "string" ? args.section : void 0,
 		action: typeof args.action === "string" ? args.action : void 0
@@ -45317,10 +45449,22 @@ async function counted(command, args, telemetry, run) {
 		else trackTelemetryReportComplete(report, telemetry());
 		return result;
 	} catch (error) {
-		if (report && telemetry) trackTelemetryReportFailed(report, error, telemetry());
-		return toolError(localError(error));
+		const failure = localError(error);
+		if (report && telemetry) trackTelemetryReportFailed(report, failure, telemetry());
+		return toolError(failure);
 	}
 }
+async function counted(command, args, telemetry, run) {
+	const result = await countedRun(command, args, telemetry, run);
+	const notice = updateNotice();
+	return notice ? {
+		...result,
+		content: [...result.content, {
+			type: "text",
+			text: notice
+		}]
+	} : result;
+}
 function registerSharedTools(server, options = {}) {
 	const surface = {
 		deps: nodeCommandDeps({ call: mcpCall }),
@@ -45433,6 +45577,7 @@ async function startMcpServer(opts = {}) {
 	}
 	const transport = new StdioServerTransport();
 	await server.connect(transport);
+	updateNotice();
 }
 //#endregion
 export { AGENT_STRUCTURED_OUTPUT_MAX_BYTES, REPORT_CATEGORIES, compactAgentWorkflowOutput, createServer, describeReport, executeReport, listReports, runReport, startMcpServer };