@klarkxy/dsh-web-search-manager 0.1.11 → 0.2.0

package/lib/client.js

@@ -1,168 +1,7 @@
-function __createDshNodeShims() {
-  class EventEmitter {
-    constructor() {
-      this._e = Object.create(null)
-    }
-    on(type, fn) {
-      (this._e[type] ||= []).push(fn)
-      return this
-    }
-    addListener(type, fn) {
-      return this.on(type, fn)
-    }
-    once(type, fn) {
-      const wrap = (...args) => {
-        this.off(type, wrap)
-        fn(...args)
-      }
-      return this.on(type, wrap)
-    }
-    off(type, fn) {
-      const list = this._e[type]
-      if (list) this._e[type] = list.filter((item) => item !== fn)
-      return this
-    }
-    removeListener(type, fn) {
-      return this.off(type, fn)
-    }
-    emit(type, ...args) {
-      const list = this._e[type]
-      if (!list) return false
-      for (const fn of list.slice()) fn(...args)
-      return true
-    }
-    removeAllListeners(type) {
-      if (type) delete this._e[type]
-      else this._e = Object.create(null)
-      return this
-    }
-    listeners(type) {
-      return (this._e[type] || []).slice()
-    }
-    setMaxListeners() {
-      return this
-    }
-  }
-
-  class Buffer extends Uint8Array {
-    static from(value, encodingOrOffset, length) {
-      if (typeof value === 'string') return new Buffer(new TextEncoder().encode(value))
-      if (value instanceof ArrayBuffer) return new Buffer(new Uint8Array(value, encodingOrOffset, length))
-      if (ArrayBuffer.isView(value)) return new Buffer(new Uint8Array(value.buffer, value.byteOffset, value.byteLength))
-      if (Array.isArray(value) || value && typeof value.length === 'number') return new Buffer(Uint8Array.from(value))
-      return new Buffer(0)
-    }
-    static alloc(size, fill) {
-      const buf = new Buffer(size)
-      if (fill !== undefined && fill !== 0) {
-        if (typeof fill === 'string') {
-          const bytes = new TextEncoder().encode(fill)
-          for (let i = 0; i < size; i += 1) buf[i] = bytes[i % bytes.length]
-        } else buf.fill(fill)
-      }
-      return buf
-    }
-    static allocUnsafe(size) {
-      return new Buffer(size)
-    }
-    static allocUnsafeSlow(size) {
-      return new Buffer(size)
-    }
-    static concat(list, totalLength) {
-      const length = totalLength ?? list.reduce((sum, item) => sum + item.length, 0)
-      const out = new Buffer(length)
-      let offset = 0
-      for (const item of list) {
-        out.set(item, offset)
-        offset += item.length
-      }
-      return out
-    }
-    static isBuffer(value) {
-      return value instanceof Buffer
-    }
-    static byteLength(value) {
-      if (typeof value === 'string') return new TextEncoder().encode(value).length
-      return value?.byteLength ?? value?.length ?? 0
-    }
-    static isEncoding(encoding) {
-      return /^(utf8|utf-8|ascii|latin1|binary|hex|base64|base64url)$/i.test(String(encoding || ''))
-    }
-    toString(encoding) {
-      if (encoding === 'hex') return [...this].map((byte) => byte.toString(16).padStart(2, '0')).join('')
-      if (encoding === 'base64') {
-        let binary = ''
-        this.forEach((byte) => {
-          binary += String.fromCharCode(byte)
-        })
-        return btoa(binary)
-      }
-      return new TextDecoder().decode(this)
-    }
-    slice(start, end) {
-      return Buffer.from(super.subarray(start, end))
-    }
-    copy(target, targetStart = 0, start = 0, end = this.length) {
-      const sliced = this.subarray(start, end)
-      target.set(sliced, targetStart)
-      return sliced.length
-    }
-    write(string, offset = 0) {
-      const bytes = new TextEncoder().encode(string)
-      const written = Math.min(bytes.length, this.length - offset)
-      this.set(bytes.subarray(0, written), offset)
-      return written
-    }
-  }
-
-  function inherits(ctor, superCtor) {
-    ctor.super_ = superCtor
-    ctor.prototype = Object.create(superCtor.prototype, {
-      constructor: { value: ctor, writable: true, configurable: true },
-    })
-  }
-
-  if (!globalThis.Buffer) globalThis.Buffer = Buffer
-
-  return {
-    buffer: { Buffer, SlowBuffer: Buffer, INSPECT_MAX_BYTES: 50, kMaxLength: 0x7fffffff },
-    stream: {
-      Stream: EventEmitter,
-      Readable: EventEmitter,
-      Writable: EventEmitter,
-      Duplex: EventEmitter,
-      Transform: EventEmitter,
-      PassThrough: EventEmitter,
-    },
-    events: { EventEmitter },
-    util: {
-      deprecate(fn) {
-        return fn
-      },
-      inherits,
-      inspect() {
-        return ''
-      },
-      format(value) {
-        return String(value)
-      },
-      types: { isBuffer: Buffer.isBuffer },
-    },
-  }
-}
-
 window.__ModuleLoader__.load({
   id: "@klarkxy/dsh-web-search-manager",
   factory: (dshRequire) => {
-    var __nodeShims;
-    var process = globalThis.process || { env: {}, nextTick: function (fn) { var args = [].slice.call(arguments, 1); queueMicrotask(function () { fn.apply(null, args); }); } };
-    var require = function (id) {
-      if (id === 'buffer' || id === 'stream' || id === 'util' || id === 'events') {
-        if (!__nodeShims) __nodeShims = __createDshNodeShims();
-        return __nodeShims[id];
-      }
-      return dshRequire(id);
-    };
+    var require = dshRequire;
     var module = { exports: {} };
     var exports = module.exports;
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
@@ -542,6 +381,49 @@ ${scope} {
 `.replace(/^& (\.dsh-ui-[a-z0-9-]+)(?![+>~])/gm, (_match, className) => `&${className}, & ${className}`);
 }
 //#endregion
+//#region ../dsh-plugin-kit/src/client-utils.ts
+/** Fixed pause for failing background reads; manual work is never replayed. */
+function createPluginReadGate(now = Date.now) {
+	let pausedUntil = 0;
+	let epoch = 0;
+	return {
+		canRead: () => now() >= pausedUntil,
+		reset: () => {
+			epoch++;
+			pausedUntil = 0;
+		},
+		async run(read) {
+			const current = epoch;
+			try {
+				const value = await read();
+				if (current === epoch) pausedUntil = 0;
+				return value;
+			} catch (error) {
+				const message = error instanceof Error ? error.message : "";
+				if (current === epoch && (/(?:^|\s)transport failure for .+: HTTP (?:404|405|503)\b/.test(message) || error instanceof TypeError && /^(?:Failed to fetch|fetch failed|NetworkError when attempting to fetch resource\.?)$/i.test(message))) pausedUntil = now() + 3e4;
+				throw error;
+			}
+		}
+	};
+}
+//#endregion
+//#region src/contracts.ts
+const WEB_SEARCH_RPC_CHANNEL = "/web-search-manager";
+function pickActiveSearch(order, configured) {
+	return order.find(configured) ?? "";
+}
+function safeConfigurationUrl(value) {
+	if (typeof value !== "string" || !value || /[\u0000-\u0020\\]/.test(value)) return;
+	try {
+		const url = new URL(value, "https://dsh.invalid");
+		if (url.username || url.password) return;
+		if (value.startsWith("/") && !value.startsWith("//") || value.startsWith("#")) return url.origin === "https://dsh.invalid" ? value : void 0;
+		return /^https:\/\//i.test(value) && url.protocol === "https:" ? value : void 0;
+	} catch {
+		return;
+	}
+}
+//#endregion
 //#region src/provider-info.ts
 const PROVIDER_PRICING_CHECKED = "2026-09-21";
 const providerInfo = {
@@ -586,22 +468,37 @@ const providerInfo = {
 		pricingUrl: "https://docs.tavily.com/documentation/api-credits"
 	}
 };
-function searchProviderInfo(provider) {
-	const known = Object.hasOwn(providerInfo, provider.id) ? providerInfo[provider.id] : void 0;
-	return {
-		description: known?.description ?? provider.description,
-		pricing: provider.pricing ?? known?.pricing ?? (provider.billing === "none" ? "该后端不收取搜索费用。" : provider.billing === "model-and-tools" ? "按模型用量与工具调用计费；额度与单价见供应商说明。" : "按 API 调用计费；额度与单价见供应商说明。"),
-		pricingUrl: provider.pricingUrl ?? known?.pricingUrl ?? provider.signupUrl
-	};
+function bundledCatalogId(provider) {
+	if (!(typeof provider.configurationOwned === "boolean" ? provider.configurationOwned : !provider.configurationOwner || provider.configurationOwner === "@klarkxy/dsh-web-search-manager")) return;
+	return provider.id === "deepseek-managed" ? "deepseek-official" : provider.id;
 }
-//#endregion
-//#region src/contracts.ts
-const WEB_SEARCH_RPC_CHANNEL = "/web-search-manager";
-function resolveSearchOrder(knownIds, settings, _keyed) {
-	return [...new Set(settings.searchOrder.filter((id) => knownIds.includes(id)))];
+function missingPricing(locale) {
+	return locale === "zh" ? "未提供费用信息" : "No pricing information provided";
 }
-function pickActiveSearch(order, configured) {
-	return order.find(configured) ?? "";
+function usesBundledPricing(provider) {
+	if (provider.pricing?.trim()) return false;
+	const catalogId = bundledCatalogId(provider);
+	return Boolean(catalogId && Object.hasOwn(providerInfo, catalogId));
+}
+function searchProviderInfo(provider, locale = "zh") {
+	const catalogId = bundledCatalogId(provider);
+	const known = catalogId && Object.hasOwn(providerInfo, catalogId) ? providerInfo[catalogId] : void 0;
+	const description = provider.description.trim() ? provider.description : known?.description ?? provider.description;
+	if (provider.pricing?.trim()) return {
+		description,
+		pricing: provider.pricing,
+		pricingUrl: provider.pricingUrl ?? known?.pricingUrl ?? provider.signupUrl
+	};
+	if (known) return {
+		description,
+		pricing: known.pricing,
+		pricingUrl: provider.pricingUrl ?? known.pricingUrl ?? provider.signupUrl
+	};
+	return {
+		description,
+		pricing: missingPricing(locale),
+		pricingUrl: provider.pricingUrl ?? provider.signupUrl
+	};
 }
 //#endregion
 //#region src/client.tsx
@@ -621,32 +518,129 @@ function editable(settings) {
 	const { revision: _revision, ...rest } = settings;
 	return rest;
 }
+const STATUS_REFRESH_MS = 3e3;
+function isPageHidden(hidden) {
+	if (hidden) return true;
+	return typeof document !== "undefined" && document.visibilityState === "hidden";
+}
+function canStartStatusRead(input) {
+	if (!input.mounted) return false;
+	if (input.source === "poll") return !input.hidden && !input.busy && !input.reordering && !input.reading;
+	return true;
+}
+function isExternalConfigurationUrl(url) {
+	return /^https:\/\//i.test(url);
+}
+function shouldApplyPolledStatus(input) {
+	if (input.hidden || input.busy || input.reordering) return false;
+	if (input.requestId !== input.latestRequestId) return false;
+	if (input.currentRevision !== void 0 && input.incomingRevision < input.currentRevision) return false;
+	return true;
+}
+function bindStatusRefresh(options) {
+	const intervalMs = options.intervalMs ?? 3e3;
+	let inFlight = false;
+	let stopped = false;
+	const run = async () => {
+		if (stopped || inFlight || options.isHidden()) return;
+		inFlight = true;
+		try {
+			await options.tick();
+		} finally {
+			inFlight = false;
+		}
+	};
+	const timer = (options.setIntervalFn ?? setInterval)(() => {
+		run();
+	}, intervalMs);
+	const onVisible = () => {
+		if (!options.isHidden()) run();
+	};
+	const add = options.addListener ?? ((type, listener) => {
+		if (typeof document !== "undefined") document.addEventListener(type, listener);
+	});
+	const remove = options.removeListener ?? ((type, listener) => {
+		if (typeof document !== "undefined") document.removeEventListener(type, listener);
+	});
+	add("visibilitychange", onVisible);
+	return () => {
+		stopped = true;
+		(options.clearIntervalFn ?? clearInterval)(timer);
+		remove("visibilitychange", onVisible);
+	};
+}
 function isProviderOn(status, provider) {
-	const enabled = provider.kind === "search" ? status.searchActive : status.fetchActive;
-	const selected = status.settings[provider.kind === "search" ? "searchProvider" : "fetchProvider"];
-	return enabled && selected === provider.id;
+	if (provider.kind === "fetch") return status.fetchActive && status.settings.fetchProvider === provider.id && provider.configured;
+	return status.searchActive && selectedSearchBackend(status)?.id === provider.id;
 }
-function searchBackends(status) {
-	const all = status.providers.filter((provider) => provider.kind === "search");
-	return resolveSearchOrder(all.map((provider) => provider.id), status.settings, (id) => Boolean(all.find((provider) => provider.id === id)?.credentialRef)).flatMap((id) => all.find((provider) => provider.id === id) ?? []);
+function dormantSearchPlaceholder(id) {
+	return {
+		id,
+		label: id,
+		description: "",
+		billing: "unknown",
+		kind: "search",
+		configured: false,
+		calls: 0,
+		failures: 0,
+		configurationOwned: false
+	};
+}
+function isRegisteredSearch(status, id) {
+	return status.providers.some((provider) => provider.kind === "search" && provider.id === id);
 }
 function catalogSearchBackends(status) {
-	const enabled = searchBackends(status);
-	const rest = status.providers.filter((provider) => provider.kind === "search" && !enabled.some((row) => row.id === provider.id));
-	return [...enabled, ...rest];
+	const byId = new Map(status.providers.filter((provider) => provider.kind === "search").map((provider) => [provider.id, provider]));
+	const rows = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const id of status.settings.searchOrder) {
+		if (!id || seen.has(id)) continue;
+		seen.add(id);
+		rows.push(byId.get(id) ?? dormantSearchPlaceholder(id));
+	}
+	for (const provider of status.providers) {
+		if (provider.kind !== "search" || seen.has(provider.id)) continue;
+		rows.push(provider);
+	}
+	return rows;
+}
+function searchBackends(status) {
+	const participating = new Set(status.settings.searchOrder);
+	return catalogSearchBackends(status).filter((provider) => participating.has(provider.id));
 }
 function selectedSearchBackend(status) {
-	const backends = searchBackends(status);
+	const backends = searchBackends(status).filter((provider) => isRegisteredSearch(status, provider.id));
 	const id = pickActiveSearch(backends.map((provider) => provider.id), (id) => Boolean(backends.find((provider) => provider.id === id)?.configured));
 	return backends.find((provider) => provider.id === id);
 }
-function ExternalLink({ url, label, children }) {
+function droppedDormantIds(settings, order, providers) {
+	const known = new Set(providers.filter((provider) => provider.kind === "search").map((provider) => provider.id));
+	return [...new Set(settings.searchOrder.filter((id) => id && !known.has(id) && !order.includes(id)))];
+}
+function configurationAccess(provider) {
+	if (ownsProviderConfiguration(provider)) return { kind: "owned" };
+	const url = safeConfigurationUrl(provider.configurationUrl);
+	if (url) return {
+		kind: "link",
+		url
+	};
+	if (provider.configurationOwner?.trim()) return {
+		kind: "owner",
+		name: provider.configurationOwner
+	};
+	return { kind: "unknown" };
+}
+function AppLink({ url, label, children }) {
+	const external = isExternalConfigurationUrl(url);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
 		href: url,
-		target: "_blank",
-		rel: "noreferrer noopener",
+		...external ? {
+			target: "_blank",
+			rel: "noreferrer noopener"
+		} : {},
 		"aria-label": label,
 		onClick: (event) => {
+			if (!external) return;
 			const bridge = globalThis.dshWindow;
 			if (bridge?.openExternal) {
 				event.preventDefault();
@@ -662,9 +656,13 @@ function canEnableSearch(order, providers, keys, writable) {
 		if (!provider) return false;
 		if (provider.configured) return true;
 		const typed = (keys[provider.id] ?? "").trim();
-		return Boolean(provider.credentialRef && typed && writable[provider.credentialRef] !== false);
+		return Boolean(ownsProviderConfiguration(provider) && provider.credentialRef && typed && writable[provider.credentialRef] !== false);
 	});
 }
+function ownsProviderConfiguration(provider) {
+	if (typeof provider.configurationOwned === "boolean") return provider.configurationOwned;
+	return !provider.configurationOwner || provider.configurationOwner === "@klarkxy/dsh-web-search-manager";
+}
 function nextSearchEnabled(currentlyEnabled, nextOrder, providers, keys, writable) {
 	return currentlyEnabled && canEnableSearch(nextOrder, providers, keys, writable);
 }
@@ -716,11 +714,14 @@ const copy = {
 		dragPrefix: "拖动排序 ",
 		dragHint: "拖动排序，或用上下方向键",
 		inUse: "当前使用",
+		available: "可用",
+		unavailable: "暂不可用",
+		dormant: "未加载，保留选择",
 		signup: "去注册",
 		pricing: "费用说明",
 		website: "官网",
+		openConfig: "打开配置",
 		needsKey: "待配置 Key",
-		unavailable: "暂不可用",
 		sharedKey: "与其他设置共用凭据",
 		keyConfigured: "已配置，留空不替换",
 		keyPlaceholder: "输入 API Key",
@@ -734,7 +735,11 @@ const copy = {
 		maxResults: "每条查询结果上限",
 		maxQueries: "每次调用查询上限",
 		timeoutMs: "请求超时（毫秒）",
-		maxFetchChars: "正文字符上限"
+		maxFetchChars: "正文字符上限",
+		fetchTitle: "网页读取",
+		fetchProvider: "读取服务",
+		ownerSettings: "配置入口：",
+		unknownOwner: "请在服务所属插件中配置"
 	},
 	en: {
 		tabsLabel: "Web search settings",
@@ -756,11 +761,14 @@ const copy = {
 		dragPrefix: "Reorder ",
 		dragHint: "Drag to reorder, or use arrow keys",
 		inUse: "In use",
+		available: "Available",
+		unavailable: "Unavailable",
+		dormant: "Not loaded; selection kept",
 		signup: "Sign up",
 		pricing: "Pricing",
 		website: "Website",
+		openConfig: "Open configuration",
 		needsKey: "Key required",
-		unavailable: "Unavailable",
 		sharedKey: "Shares a credential with other settings",
 		keyConfigured: "Configured; empty keeps it",
 		keyPlaceholder: "Enter API key",
@@ -774,14 +782,18 @@ const copy = {
 		maxResults: "Max results/query",
 		maxQueries: "Max queries/call",
 		timeoutMs: "Request timeout (ms)",
-		maxFetchChars: "Max text chars"
+		maxFetchChars: "Max text chars",
+		fetchTitle: "Read web pages",
+		fetchProvider: "Fetch service",
+		ownerSettings: "Configure in: ",
+		unknownOwner: "Configure this service in its plugin"
 	}
 };
 function movedText(locale, label, position) {
 	return locale === "zh" ? `${label} 已移至第 ${position} 位` : `${label} moved to position ${position}`;
 }
 function pricingCheckedText(locale, date) {
-	return locale === "zh" ? `价格核对于 ${date}，额度与费用以供应商账户为准。` : `Prices checked on ${date}; your provider account is authoritative.`;
+	return locale === "zh" ? `内置适配器价格核对于 ${date}，额度与费用以供应商账户为准。` : `Bundled adapter prices checked on ${date}; your provider account is authoritative.`;
 }
 function testOkText(locale, sources) {
 	return locale === "zh" ? `连接正常，返回 ${sources} 条来源。` : `Connection OK: ${sources} sources returned.`;
@@ -822,13 +834,25 @@ function parseLimit(raw, min, max) {
 * Settings written by an immediate action (a switch or a reorder). It keeps the
 * saved limits and never includes typed-but-unsaved keys or limit drafts.
 */
-function immediateUpdate(settings, on, order) {
+function immediateUpdate(settings, on, order, providers, remove = []) {
+	let searchOrder = order;
+	if (providers) {
+		const known = new Set(providers.filter((provider) => provider.kind === "search").map((provider) => provider.id));
+		const removed = new Set(remove);
+		const following = order.filter((id) => !removed.has(id));
+		if (following.some((id) => !known.has(id))) searchOrder = following;
+		else {
+			searchOrder = settings.searchOrder.flatMap((id) => {
+				if (removed.has(id)) return [];
+				return known.has(id) ? following.splice(0, 1) : [id];
+			});
+			searchOrder.push(...following);
+		}
+	}
 	return {
 		...editable(settings),
-		searchOrder: order,
-		searchEnabled: on,
-		fetchProvider: "http",
-		fetchEnabled: on
+		searchOrder,
+		searchEnabled: on
 	};
 }
 function limitTexts(settings) {
@@ -846,7 +870,7 @@ function useHostLocale(client) {
 }
 /** Keyboard reorders are batched: persist once the arrows stop for this long. */
 const REORDER_DEBOUNCE_MS = 500;
-function NetworkSearchSettings({ client }) {
+function NetworkSearchSettings({ client, hidden }) {
 	const locale = useHostLocale(client);
 	const text = copy[locale];
 	const tabsId = (0, react.useId)();
@@ -870,6 +894,17 @@ function NetworkSearchSettings({ client }) {
 	const timerRef = (0, react.useRef)(void 0);
 	const handleRefs = (0, react.useRef)(/* @__PURE__ */ new Map());
 	const refocusRef = (0, react.useRef)(null);
+	const busyRef = (0, react.useRef)(false);
+	const hiddenRef = (0, react.useRef)(hidden);
+	hiddenRef.current = hidden;
+	const requestSeq = (0, react.useRef)(0);
+	const mountedRef = (0, react.useRef)(true);
+	const readingRef = (0, react.useRef)(false);
+	const readingRequest = (0, react.useRef)(0);
+	const statusRead = (0, react.useRef)(Promise.resolve());
+	const readGateRef = (0, react.useRef)(void 0);
+	if (!readGateRef.current) readGateRef.current = createPluginReadGate();
+	const readGate = readGateRef.current;
 	async function call(endpoint, payload = {}) {
 		return unwrap(await client.connection.rpc.call(WEB_SEARCH_RPC_CHANNEL, endpoint, payload));
 	}
@@ -885,30 +920,109 @@ function NetworkSearchSettings({ client }) {
 		});
 		if (resetDraft) setInvalid({});
 	}
-	async function load(resetDraft = false) {
-		const next = await call("status");
-		adopt(next, resetDraft);
-		setLoadError("");
-		const refs = next.providers.flatMap((provider) => provider.credentialRef ? [provider.credentialRef] : []);
-		if (refs.length) {
-			const credentials = unwrap(await client.remote.credentials.describe(refs));
-			setWritable(Object.fromEntries(Object.entries(credentials).map(([ref, value]) => [ref, value.writable])));
+	function pollBlocked() {
+		return !canStartStatusRead({
+			source: "poll",
+			mounted: mountedRef.current,
+			hidden: isPageHidden(hiddenRef.current),
+			busy: busyRef.current,
+			reordering: pendingRef.current !== null,
+			reading: readingRef.current
+		});
+	}
+	async function describeOwned(next, mine) {
+		const refs = next.providers.flatMap((provider) => ownsProviderConfiguration(provider) && provider.credentialRef ? [provider.credentialRef] : []);
+		if (!refs.length) return;
+		const credentials = unwrap(await readGate.run(() => client.remote.credentials.describe(refs)));
+		if (!mountedRef.current || mine !== requestSeq.current) return;
+		setWritable(Object.fromEntries(Object.entries(credentials).map(([ref, value]) => [ref, value.writable])));
+	}
+	async function load(resetDraft = false, source = "user") {
+		if (source === "poll" && !readGate.canRead()) return;
+		if (source === "user") {
+			readGate.reset();
+			requestSeq.current += 1;
+		}
+		while (readingRef.current) {
+			if (source === "poll" || !mountedRef.current) return;
+			await statusRead.current;
+		}
+		if (!mountedRef.current) return;
+		if (source === "poll" && pollBlocked()) return;
+		const mine = ++requestSeq.current;
+		readingRef.current = true;
+		readingRequest.current = mine;
+		let release = () => {};
+		statusRead.current = new Promise((resolve) => {
+			release = resolve;
+		});
+		try {
+			const next = unwrap(await readGate.run(() => client.connection.rpc.call(WEB_SEARCH_RPC_CHANNEL, "status", {})));
+			if (!mountedRef.current || mine !== requestSeq.current) return next;
+			if (source === "poll" && !shouldApplyPolledStatus({
+				requestId: mine,
+				latestRequestId: requestSeq.current,
+				busy: busyRef.current,
+				reordering: pendingRef.current !== null,
+				hidden: isPageHidden(hiddenRef.current),
+				currentRevision: statusRef.current?.settings.revision,
+				incomingRevision: next.settings.revision
+			})) return next;
+			adopt(next, resetDraft);
+			setLoadError("");
+			await describeOwned(next, mine);
+			return next;
+		} catch (cause) {
+			if (!mountedRef.current || mine !== requestSeq.current) return;
+			setLoadError(cause instanceof Error && cause.message ? cause.message : text.failed);
+			if (source === "poll") return;
+			throw cause;
+		} finally {
+			if (readingRequest.current === mine) readingRef.current = false;
+			release();
 		}
-		return next;
 	}
 	(0, react.useEffect)(() => {
+		mountedRef.current = true;
+		readGate.reset();
 		load().catch((cause) => setLoadError(cause instanceof Error && cause.message ? cause.message : text.failed));
+		const bind = () => bindStatusRefresh({
+			isHidden: () => isPageHidden(hiddenRef.current),
+			tick: async () => {
+				await load(false, "poll").catch(() => {});
+			}
+		});
+		let stop = bind();
+		const stopConnection = client.connection.generation?.subscribe(() => {
+			readGate.reset();
+			requestSeq.current += 1;
+			readingRef.current = false;
+			statusRead.current = Promise.resolve();
+			stop();
+			stop = bind();
+			load(false, "poll");
+		});
+		return () => {
+			mountedRef.current = false;
+			readGate.reset();
+			requestSeq.current += 1;
+			stop();
+			stopConnection?.();
+			if (timerRef.current === void 0) return;
+			clearTimeout(timerRef.current);
+			const current = statusRef.current;
+			const next = pendingRef.current;
+			if (current && next) call("update", {
+				settings: immediateUpdate(current.settings, current.settings.searchEnabled, next, current.providers),
+				expectedRevision: current.settings.revision
+			}).catch(() => {});
+		};
 	}, [client]);
-	(0, react.useEffect)(() => () => {
-		if (timerRef.current === void 0) return;
-		clearTimeout(timerRef.current);
-		const current = statusRef.current;
-		const next = pendingRef.current;
-		if (current && next) call("update", {
-			settings: immediateUpdate(current.settings, current.settings.searchEnabled, next),
-			expectedRevision: current.settings.revision
-		}).catch(() => {});
-	}, []);
+	(0, react.useEffect)(() => {
+		if (hidden) return;
+		if (!statusRef.current) return;
+		load(false, "poll").catch(() => {});
+	}, [hidden]);
 	(0, react.useLayoutEffect)(() => {
 		const id = refocusRef.current;
 		if (!id) return;
@@ -917,6 +1031,9 @@ function NetworkSearchSettings({ client }) {
 		if (handle && document.activeElement !== handle) handle.focus();
 	});
 	async function action(run) {
+		readGate.reset();
+		requestSeq.current += 1;
+		busyRef.current = true;
 		setBusy(true);
 		setNote("");
 		setError("");
@@ -926,11 +1043,12 @@ function NetworkSearchSettings({ client }) {
 			setError(cause instanceof Error && cause.message ? cause.message : text.failed);
 			await load().catch(() => {});
 		} finally {
+			busyRef.current = false;
 			setBusy(false);
 		}
 	}
 	/** Switches and reorders: settings only, applied at once. */
-	function runImmediate(on, order) {
+	function runImmediate(on, order, remove = []) {
 		clearTimeout(timerRef.current);
 		timerRef.current = void 0;
 		pendingRef.current = null;
@@ -938,7 +1056,7 @@ function NetworkSearchSettings({ client }) {
 			const current = statusRef.current;
 			if (!current) return;
 			const next = await call("update", {
-				settings: immediateUpdate(current.settings, on, order),
+				settings: immediateUpdate(current.settings, on, order, current.providers, remove),
 				expectedRevision: current.settings.revision
 			});
 			setStatus(next);
@@ -954,7 +1072,7 @@ function NetworkSearchSettings({ client }) {
 			if (provider.kind !== "search" || only && provider.id !== only.id) continue;
 			const snapshot = keys[provider.id] ?? "";
 			const typed = snapshot.trim();
-			if (!provider.credentialRef || !typed) continue;
+			if (!ownsProviderConfiguration(provider) || !provider.credentialRef || !typed) continue;
 			if (writable[provider.credentialRef] === false) throw new Error(text.readOnly);
 			unwrap(await client.remote.credentials.set(provider.credentialRef, typed));
 			setKeys((current) => current[provider.id] === snapshot ? {
@@ -964,7 +1082,7 @@ function NetworkSearchSettings({ client }) {
 		}
 	}
 	async function removeKey(provider) {
-		if (!provider.credentialRef || provider.credentialShared || !status) return;
+		if (!ownsProviderConfiguration(provider) || !provider.credentialRef || provider.credentialShared || !status) return;
 		unwrap(await client.remote.credentials.unset(provider.credentialRef));
 		setKeys((current) => ({
 			...current,
@@ -1053,9 +1171,7 @@ function NetworkSearchSettings({ client }) {
 			adopt(await call("update", {
 				settings: {
 					...editable(current.settings),
-					...parsed,
-					fetchProvider: "http",
-					fetchEnabled: current.settings.searchEnabled
+					...parsed
 				},
 				expectedRevision: current.settings.revision
 			}), true);
@@ -1094,6 +1210,22 @@ function NetworkSearchSettings({ client }) {
 				className: "dsh-ui-error",
 				children: error
 			}),
+			loadError ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "dsh-ui-stack",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+					role: "alert",
+					className: "dsh-ui-error",
+					children: [text.loadFailed, loadError]
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "outline",
+					size: "sm",
+					disabled: busy,
+					onClick: () => void action(async () => {
+						await load();
+					}),
+					children: text.reconnect
+				})]
+			}) : null,
 			note && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				role: "status",
 				className: "dsh-ui-notice",
@@ -1104,13 +1236,13 @@ function NetworkSearchSettings({ client }) {
 				className: "dsh-ui-banner dsh-ui-banner--danger",
 				children: text.storageFailed
 			}),
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				role: "tabpanel",
 				id: tabsId + "-providers-panel",
 				"aria-labelledby": tabsId + "-providers-tab",
 				hidden: tab !== "providers",
 				tabIndex: 0,
-				children: backends.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				children: [backends.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 					className: "dsh-ui-empty",
 					children: text.empty
 				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("article", {
@@ -1139,17 +1271,23 @@ function NetworkSearchSettings({ client }) {
 							children: backends.map((provider) => {
 								const participating = order.includes(provider.id);
 								const rank = order.indexOf(provider.id);
-								const active = saved.searchActive && selected?.id === provider.id;
-								const info = searchProviderInfo(provider);
-								const needsKey = Boolean(provider.credentialRef);
+								const dormant = !isRegisteredSearch(saved, provider.id);
+								const active = !dormant && saved.searchActive && selected?.id === provider.id;
+								const info = searchProviderInfo(provider, locale);
+								const owned = ownsProviderConfiguration(provider);
+								const access = configurationAccess(provider);
+								const needsKey = owned && Boolean(provider.credentialRef);
 								const shared = Boolean(provider.credentialShared);
-								const showKey = needsKey && participating && (!shared || !provider.configured);
+								const showKey = !dormant && needsKey && participating && (!shared || !provider.configured);
 								const canSort = participating && order.length > 1;
 								const readOnly = writable[provider.credentialRef ?? ""] === false;
 								const typedKey = (keys[provider.id] ?? "").trim();
+								const availability = dormant ? "dormant" : provider.configured ? "available" : "unavailable";
 								return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
 									className: active ? "is-active" : void 0,
 									"data-testid": `web-search-rank-${provider.id}`,
+									"data-availability": availability,
+									"data-in-use": active || void 0,
 									"data-dragging": dragSource === provider.id || void 0,
 									"data-drop": dropTarget === provider.id && dragSource ? order.indexOf(dragSource) < rank ? "after" : "before" : void 0,
 									onDragOver: (event) => {
@@ -1251,11 +1389,15 @@ function NetworkSearchSettings({ client }) {
 															className: "dsh-ui-heading",
 															children: provider.label
 														}),
+														/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+															className: "ws-provider-note",
+															children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: dormant ? "idle" : provider.configured ? "done" : "warning" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: dormant ? text.dormant : provider.configured ? text.available : text.unavailable })]
+														}),
 														active && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tag, {
 															tone: "success",
 															children: text.inUse
 														}),
-														provider.signupUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExternalLink, {
+														provider.signupUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AppLink, {
 															url: provider.signupUrl,
 															label: provider.label + " " + text.signup,
 															children: text.signup
@@ -1264,20 +1406,30 @@ function NetworkSearchSettings({ client }) {
 												}),
 												/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 													className: "web-search-provider-info",
-													children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: info.description }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", { children: [info.pricing, info.pricingUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [" ", /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExternalLink, {
+													children: [info.description ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: info.description }) : null, /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", { children: [info.pricing, info.pricingUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [" ", /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AppLink, {
 														url: info.pricingUrl,
 														label: provider.label + " " + text.pricing,
 														children: provider.id === "ddg" ? text.website : text.pricing
 													})] })] })]
 												}),
-												participating && !provider.configured ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
-													className: "ws-provider-note",
-													children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "warning" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: needsKey ? text.needsKey : text.unavailable })]
+												access.kind === "link" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+													className: "dsh-ui-hint",
+													children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AppLink, {
+														url: access.url,
+														label: text.openConfig,
+														children: text.openConfig
+													})
+												}) : access.kind === "owner" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+													className: "dsh-ui-hint",
+													children: [text.ownerSettings, access.name]
+												}) : access.kind === "unknown" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+													className: "dsh-ui-hint",
+													children: text.unknownOwner
 												}) : null,
-												shared && participating && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("small", {
+												shared && participating && owned ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("small", {
 													className: "dsh-ui-meta",
 													children: provider.credentialHint ?? text.sharedKey
-												}),
+												}) : null,
 												showKey ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
 													className: "dsh-ui-field",
 													children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -1326,7 +1478,7 @@ function NetworkSearchSettings({ client }) {
 												disabled: busy,
 												onChange: (next) => {
 													const following = next ? [...order, provider.id] : order.filter((id) => id !== provider.id);
-													runImmediate(nextSearchEnabled(saved.settings.searchEnabled, following, saved.providers, {}, writable), following);
+													runImmediate(nextSearchEnabled(saved.settings.searchEnabled, following, saved.providers, {}, writable), following, droppedDormantIds(saved.settings, following, saved.providers));
 												}
 											})
 										})
@@ -1334,10 +1486,10 @@ function NetworkSearchSettings({ client }) {
 								}, provider.id);
 							})
 						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						backends.some(usesBundledPricing) ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 							className: "dsh-ui-hint",
 							children: pricingCheckedText(locale, PROVIDER_PRICING_CHECKED)
-						}),
+						}) : null,
 						on ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 							className: "dsh-ui-actions",
 							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
@@ -1354,7 +1506,104 @@ function NetworkSearchSettings({ client }) {
 							})
 						}) : null
 					]
-				})
+				}), (saved.providers.some((provider) => provider.kind === "fetch") || saved.settings.fetchProvider) && (() => {
+					const fetchId = saved.settings.fetchProvider;
+					const fetchSelected = saved.providers.find((provider) => provider.kind === "fetch" && provider.id === fetchId);
+					const fetchDormant = Boolean(fetchId) && !fetchSelected;
+					const fetchActive = Boolean(fetchSelected && saved.fetchActive && fetchSelected.configured);
+					const fetchAccess = fetchSelected ? configurationAccess(fetchSelected) : fetchDormant ? { kind: "unknown" } : void 0;
+					return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("article", {
+						className: "dsh-ui-card dsh-ui-card--flat",
+						"data-testid": "web-search-fetch",
+						"data-availability": fetchDormant ? "dormant" : fetchSelected?.configured ? "available" : "unavailable",
+						"data-in-use": fetchActive || void 0,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
+								className: "ws-card-head",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+									className: "dsh-ui-title",
+									children: text.fetchTitle
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+									className: "ws-provider-note",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: fetchDormant ? "idle" : fetchSelected?.configured ? "done" : "warning" }),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: fetchDormant ? text.dormant : fetchSelected?.configured ? text.available : text.unavailable }),
+										fetchActive ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tag, {
+											tone: "success",
+											children: text.inUse
+										}) : null
+									]
+								})] }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
+									checked: saved.settings.fetchEnabled,
+									label: text.fetchTitle,
+									disabled: busy || reordering,
+									onChange: (next) => void action(async () => {
+										const current = statusRef.current;
+										adopt(await call("update", {
+											settings: {
+												...editable(current.settings),
+												fetchEnabled: next
+											},
+											expectedRevision: current.settings.revision
+										}));
+										await load();
+									})
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								className: "dsh-ui-field",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dsh-ui-label",
+									children: text.fetchProvider
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+									className: "dsh-ui-select",
+									"aria-label": text.fetchProvider,
+									value: fetchId,
+									disabled: busy || reordering,
+									onChange: (event) => {
+										const id = event.target.value;
+										action(async () => {
+											const current = statusRef.current;
+											adopt(await call("update", {
+												settings: {
+													...editable(current.settings),
+													fetchProvider: id
+												},
+												expectedRevision: current.settings.revision
+											}));
+											await load();
+										});
+									},
+									children: [fetchDormant && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("option", {
+										value: fetchId,
+										children: [
+											fetchId,
+											" · ",
+											text.dormant
+										]
+									}), saved.providers.filter((provider) => provider.kind === "fetch").map((provider) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("option", {
+										value: provider.id,
+										children: [provider.label, provider.configured ? "" : " · " + text.unavailable]
+									}, provider.id))]
+								})]
+							}),
+							fetchAccess?.kind === "link" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "dsh-ui-hint",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AppLink, {
+									url: fetchAccess.url,
+									label: text.openConfig,
+									children: text.openConfig
+								})
+							}) : fetchAccess?.kind === "owner" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+								className: "dsh-ui-hint",
+								children: [text.ownerSettings, fetchAccess.name]
+							}) : fetchAccess?.kind === "unknown" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "dsh-ui-hint",
+								children: text.unknownOwner
+							}) : null
+						]
+					});
+				})()]
 			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				role: "tabpanel",
@@ -1496,21 +1745,35 @@ function apply(ctx) {
 	ctx.effect(() => client.slots.inject("plugins.bundle.config", () => client.slots.register({
 		name: "plugins.bundle.config",
 		key: "@klarkxy/dsh-web-search-manager"
-	}, () => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NetworkSearchSettings, { client }))), "web-search-manager.settings");
+	}, (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NetworkSearchSettings, {
+		client,
+		hidden: props?.hidden
+	}))), "web-search-manager.settings");
 }
 //#endregion
 exports.NetworkSearchSettings = NetworkSearchSettings;
+exports.STATUS_REFRESH_MS = STATUS_REFRESH_MS;
 exports.apply = apply;
+exports.bindStatusRefresh = bindStatusRefresh;
 exports.canEnableSearch = canEnableSearch;
+exports.canStartStatusRead = canStartStatusRead;
 exports.catalogSearchBackends = catalogSearchBackends;
+exports.configurationAccess = configurationAccess;
+exports.dormantSearchPlaceholder = dormantSearchPlaceholder;
+exports.droppedDormantIds = droppedDormantIds;
 exports.immediateUpdate = immediateUpdate;
 exports.inject = inject;
+exports.isExternalConfigurationUrl = isExternalConfigurationUrl;
+exports.isPageHidden = isPageHidden;
 exports.isProviderOn = isProviderOn;
+exports.isRegisteredSearch = isRegisteredSearch;
 exports.name = name;
 exports.nextSearchEnabled = nextSearchEnabled;
+exports.ownsProviderConfiguration = ownsProviderConfiguration;
 exports.parseLimit = parseLimit;
 exports.searchBackends = searchBackends;
 exports.selectedSearchBackend = selectedSearchBackend;
+exports.shouldApplyPolledStatus = shouldApplyPolledStatus;
 
 //# sourceMappingURL=client.inner.cjs.map
     return module.exports;