dsh-plugin-effort-declare 0.1.2 → 0.1.3

package/CONTRIBUTING.en.md

@@ -52,6 +52,8 @@ pnpm pack      # confirm the tarball contains lib/ and cordis.patch.yml
 pnpm publish
 ```
 
+The settings footer version and copyright end year are frozen into the client bundle at `pnpm build` (`package.json` version plus the UTC year at that moment). Bump the version, then build / publish. Do not read the wall clock at DSH startup.
+
 `pnpm publish` fails on an unclean Git tree. Commit first (and preferably push). Do not pass `--no-git-checks`.
 
 After publish, users update with `dsh plugin --profile web update dsh-plugin-effort-declare` or `add dsh-plugin-effort-declare@latest`. Authors do not implement an update command; official `dsh plugin` forwards the rest of the line to pnpm.

package/CONTRIBUTING.md

@@ -52,6 +52,8 @@ pnpm pack      # 确认 tarball 含 lib/ 与 cordis.patch.yml
 pnpm publish
 ```
 
+页脚版本与版权结束年在 `pnpm build` 时写入 client bundle（`package.json` 的 version + 当时的 UTC 年）。先改 version 再 build / publish。不要在运行时读系统时钟。
+
 `pnpm publish` 在 Git 有未提交改动时会失败。应先 commit（建议再 push），不要用 `--no-git-checks` 绕过。
 
 发布后用户用 `dsh plugin --profile web update dsh-plugin-effort-declare` 或 `add dsh-plugin-effort-declare@latest` 更新。作者无需在插件里实现更新命令；官方 `dsh plugin` 会把参数转给 pnpm。

package/INSTALL.en.md

@@ -83,7 +83,7 @@ dsh plugin --profile web add file:/absolute/path/to/dsh-plugin-effort-declare
 
 ## After install
 
-Restart DSH. Open **Settings → Reasoning efforts**. Add a custom provider on the Models page first; otherwise this page has nothing to edit.
+Restart DSH. Open **Settings → Reasoning efforts**. The footer is the installed version (for example `0.1.3 © 2026 Stardust`); bumping `package.json` only shows up after you rebuild and reinstall. Add a custom provider on the Models page first; otherwise this page has nothing to edit.
 
 ## Uninstall
 

package/INSTALL.md

@@ -83,7 +83,7 @@ dsh plugin --profile web add file:/绝对路径/dsh-plugin-effort-declare
 
 ## 装完之后
 
-重启 DSH。打开 **设置 → 推理档位**。先在「模型」页添加第三方提供方，本页才会出现可编辑的条目。
+重启 DSH。打开 **设置 → 推理档位**。页脚是当前装上的版本（例如 `0.1.3 © 2026 Stardust`），改 `package.json` 后必须重新打包再安装才会变。先在「模型」页添加第三方提供方，本页才会出现可编辑的条目。
 
 ## 卸载
 

package/README.en.md

@@ -34,6 +34,7 @@ Hand-added third-party providers on the Models page need a reasoning-level decla
 | Reasoning efforts page | Choose levels per model; change the gateway spelling if it differs |
 | Presets | DeepSeek compatible, OpenAI compatible, or on/off only. A preset **replaces** that dialect; it does not stack |
 | vs Models | Models owns the endpoint, keys, and model list; this page only declares which reasoning levels are offered |
+| Version footer | Bottom of the page shows the plugin version and copyright years (frozen at pack time; opening DSH does not advance the year) |
 
 ## Install
 
@@ -51,7 +52,7 @@ dsh plugin --profile web update dsh-plugin-effort-declare
 
 Or `add dsh-plugin-effort-declare@latest`. Details: [install guide](./INSTALL.en.md) **Update**.
 
-Restart DSH, then open **Settings → Reasoning efforts**. Add a custom provider on the Models page first. GitHub, local folder, and uninstall: [install guide](./INSTALL.en.md).
+Restart DSH, then open **Settings → Reasoning efforts**. The footer shows which version is installed. Add a custom provider on the Models page first. GitHub, local folder, and uninstall: [install guide](./INSTALL.en.md).
 
 ## Usage
 

package/README.md

@@ -34,6 +34,7 @@
 | 推理档位页 | 按模型勾选可选档位；网关用的名字如果不同，可以改拼写 |
 | 预设 | DeepSeek 兼容、OpenAI 兼容、只开/关思考。点预设会换成那一套，不是叠加上去 |
 | 和「模型」页 | 「模型」管地址、密钥和模型名单；本页只管「能选哪些推理档」 |
+| 版本页脚 | 页面底部显示当前插件版本与版权年（打包时写入；打开 DSH 不会跟着日历变） |
 
 ## 安装
 
@@ -51,7 +52,7 @@ dsh plugin --profile web update dsh-plugin-effort-declare
 
 或 `add dsh-plugin-effort-declare@latest`。详见 [安装说明](./INSTALL.md) 的「更新」。
 
-装完后重启 DSH，打开 **设置 → 推理档位**。请先在「模型」页添加过第三方提供方。GitHub、本地文件夹和卸载也在 [安装说明](./INSTALL.md)。
+装完后重启 DSH，打开 **设置 → 推理档位**。页脚可核对装上的版本。请先在「模型」页添加过第三方提供方。GitHub、本地文件夹和卸载也在 [安装说明](./INSTALL.md)。
 
 ## 使用
 

package/lib/client.js

@@ -389,7 +389,10 @@ window.__ModuleLoader__.load({
 			const next = { ...efforts };
 			delete next.off;
 			if (mode === "empty") next.off = null;
-			else if (mode === "value") next.off = value.trim().length > 0 ? value : "none";
+			else if (mode === "value") {
+				const trimmed = value.trim();
+				next.off = trimmed.length > 0 ? trimmed : "none";
+			}
 			return next;
 		}
 		/** Whether a thinking level (other than Off) is currently declared. */
@@ -528,20 +531,104 @@ window.__ModuleLoader__.load({
 			return validateReasoningEfforts(row.reasoningEfforts);
 		}
 		//#endregion
+		//#region src/core/attribution.ts
+		/**
+		* Plugin footer attribution. Version and end-year are frozen into the client
+		* bundle at pack time; this module only formats the line.
+		*/
+		/** First publication year (LICENSE). Not the user's wall clock. */
+		const COPYRIGHT_FROM = 2026;
+		const COPYRIGHT_HOLDER = "Stardust";
+		/**
+		* `0.1.2 © 2026 Stardust` or `0.1.2 © 2026–2027 Stardust`.
+		* Throws if version is empty or `to < from` — a bad stamp must not render.
+		*/
+		function formatAttribution(version, from, to) {
+			if (version.trim() === "") throw new Error("plugin version must be a non-empty string");
+			if (!Number.isInteger(from) || !Number.isInteger(to) || to < from) throw new Error(`invalid copyright range: ${String(from)}\u2013${String(to)}`);
+			return `${version} \u00a9 ${to === from ? String(from) : `${String(from)}\u2013${String(to)}`} ${COPYRIGHT_HOLDER}`;
+		}
+		//#endregion
+		//#region src/client/build-info.ts
+		/**
+		* Footer line frozen into the client bundle. Do not read the clock or
+		* package.json at DSH startup — host apply is empty and the settings page
+		* runs in the browser.
+		*/
+		const PLUGIN_FOOTER_TEXT = formatAttribution("0.1.3", COPYRIGHT_FROM, 2026);
+		//#endregion
 		//#region src/client/load-drafts.ts
 		function schemaDefaultString(node) {
 			if (!isPlainObject(node) || !isPlainObject(node.meta)) return void 0;
 			return typeof node.meta.default === "string" ? node.meta.default : void 0;
 		}
+		/** Namespace revision on a describe snapshot, if that row exists. */
+		function namespaceRevision(snapshot, ns) {
+			return snapshot.view?.namespaces.find((view) => view.ns === ns)?.revision;
+		}
 		/**
-		* First paint: `ensure()` (reads only from idle). Never treat ensure as refresh.
-		* Callers that must not apply a stale settlement compare generation themselves.
-		*
-		* `formats` is the live schema union only. Empty means the dropdown has no
-		* writable choices (stored values stay visible via `thinkingFormatChoices`).
+		* True when `incoming` is the Host echo of a mutate this page already folded,
+		* or an older revision the snapshot has already passed. `echoed` is undefined
+		* until the first successful write.
+		*/
+		function isOwnDocumentEcho(echoed, incoming) {
+			return echoed !== void 0 && incoming <= echoed;
+		}
+		/**
+		* After a preserve-dirty reload: conflicted cards get a conflict notice;
+		* live cards drop leftover conflict/error; saved notices stay; gone cards drop.
 		*/
-		async function loadDrafts(api, describe, schema) {
-			await describe.ensure();
+		function foldReloadNotices(current, args) {
+			const live = new Set(args.liveProviders);
+			const conflicted = new Set(args.conflicted);
+			const next = {};
+			for (const [provider, notice] of Object.entries(current)) {
+				if (!live.has(provider)) continue;
+				if (conflicted.has(provider)) continue;
+				if (notice.kind === "conflict" || notice.kind === "error") continue;
+				next[provider] = notice;
+			}
+			for (const provider of args.conflicted) next[provider] = args.conflictNotice;
+			return next;
+		}
+		function waitUntil(describe, predicate, signal) {
+			if (signal?.aborted) return Promise.resolve(false);
+			if (predicate()) return Promise.resolve(true);
+			return new Promise((resolve) => {
+				let settled = false;
+				const finish = (ok) => {
+					if (settled) return;
+					settled = true;
+					stop();
+					signal?.removeEventListener("abort", onAbort);
+					resolve(ok);
+				};
+				const onAbort = () => {
+					finish(false);
+				};
+				const stop = describe.subscribe(() => {
+					if (predicate()) finish(true);
+				});
+				signal?.addEventListener("abort", onAbort);
+				if (predicate()) finish(true);
+				else if (signal?.aborted) finish(false);
+			});
+		}
+		/** Resolve when the mirror's namespace revision is at least `revision`, or abort. */
+		async function waitForNamespaceRevision(describe, ns, revision, signal) {
+			return await waitUntil(describe, () => {
+				const current = namespaceRevision(describe.getSnapshot(), ns);
+				return current !== void 0 && current >= revision;
+			}, signal) ? "matched" : "aborted";
+		}
+		/** Resolve when the namespace revision differs from `previous`, or abort. */
+		async function waitForNamespaceRevisionChange(describe, ns, previous, signal) {
+			return await waitUntil(describe, () => {
+				const current = namespaceRevision(describe.getSnapshot(), ns);
+				return current !== void 0 && current !== previous;
+			}, signal) ? "changed" : "aborted";
+		}
+		async function assembleDrafts(api, describe, schema) {
 			const mirrored = describe.getSnapshot();
 			if (mirrored.view === void 0) return {
 				writable: false,
@@ -592,6 +679,14 @@ window.__ModuleLoader__.load({
 				drafts
 			};
 		}
+		/**
+		* `ensure`: first paint / idle recovery (official ensure only reads from idle).
+		* `snapshot`: refresh after the mirror revision already moved — do not ensure.
+		*/
+		async function loadDrafts(api, describe, schema, mode = "ensure") {
+			if (mode === "ensure") await describe.ensure();
+			return assembleDrafts(api, describe, schema);
+		}
 		//#endregion
 		//#region src/client/schema-ops.ts
 		/** Wrap a live settingsSchema service as plain callbacks. */
@@ -624,7 +719,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:C:\Users\zimo\AppData\Roaming\io.github.hairyf.deepseek-harness-desktop\data\dsh\临时目录\dsh-plugin-effort-declare\src\client\effort-declare.module.css.mjs
-		const cssText = ".hYEBUa_section{max-width:720px;color:var(--dsw-alias-label-primary);flex-direction:column;gap:12px;display:flex}.hYEBUa_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:500;line-height:24px}.hYEBUa_intro{color:var(--dsw-alias-label-tertiary);margin:0;font-size:14px;line-height:22px}.hYEBUa_notice{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}.hYEBUa_savedNotice{color:var(--dsw-alias-state-success-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_rows{flex-direction:column;gap:8px;margin:12px 0 0;padding:0;list-style:none;display:flex}.hYEBUa_rowCard{border:1px solid var(--dsw-alias-border-l2);border-radius:12px;flex-direction:column;gap:12px;padding:12px 14px;display:flex}.hYEBUa_rowHead{align-items:baseline;gap:8px;display:flex}.hYEBUa_rowName{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.hYEBUa_rowTag{border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary);border-radius:4px;flex:none;padding:1px 6px;font-size:11px;line-height:16px}.hYEBUa_compatSummary{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.hYEBUa_presetRow,.hYEBUa_actions{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_fieldLabel{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:500;line-height:18px}.hYEBUa_primaryButton,.hYEBUa_secondaryButton{box-sizing:border-box;height:36px;font:inherit;cursor:pointer;border-radius:18px;justify-content:center;align-items:center;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.hYEBUa_primaryButton{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border:none}.hYEBUa_primaryButton:hover:not(:disabled){background:var(--dsw-alias-button-primary-hover)}.hYEBUa_secondaryButton{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);background:0 0}.hYEBUa_secondaryButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.hYEBUa_primaryButton:disabled,.hYEBUa_secondaryButton:disabled,.hYEBUa_linkButton:disabled,.hYEBUa_input:disabled{opacity:.4;cursor:default}.hYEBUa_primaryButton:focus-visible,.hYEBUa_secondaryButton:focus-visible,.hYEBUa_linkButton:focus-visible,.hYEBUa_input:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}.hYEBUa_linkButton{box-sizing:border-box;height:28px;color:var(--dsw-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:none;border-radius:14px;align-items:center;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_linkButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.hYEBUa_modelEntry{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:8px;padding:10px 0;display:flex}.hYEBUa_modelHead{flex-wrap:wrap;align-items:baseline;gap:8px;display:flex}.hYEBUa_modelId{font-size:13px;font-weight:500;line-height:20px}.hYEBUa_modelName{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}.hYEBUa_levels{flex-wrap:wrap;gap:10px 14px;display:flex}.hYEBUa_level{align-items:center;gap:6px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_wireRow{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_input,.hYEBUa_selectInput{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-module-platform);height:32px;color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;padding:0 10px;font-size:13px}.hYEBUa_wireInput{width:7em}.hYEBUa_offGroup{flex-direction:column;gap:6px;display:flex}.hYEBUa_advanced{border-top:1px solid var(--dsw-alias-border-l2);padding-top:8px}.hYEBUa_advanced summary{cursor:pointer;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}.hYEBUa_advancedBody{flex-direction:column;gap:10px;padding-top:10px;display:flex}.hYEBUa_check{align-items:flex-start;gap:8px;font-size:12px;line-height:18px;display:flex}";
+		const cssText = ".hYEBUa_section{max-width:720px;color:var(--dsw-alias-label-primary);flex-direction:column;gap:12px;display:flex}.hYEBUa_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:500;line-height:24px}.hYEBUa_intro{color:var(--dsw-alias-label-tertiary);margin:0;font-size:14px;line-height:22px}.hYEBUa_notice{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}.hYEBUa_savedNotice{color:var(--dsw-alias-state-success-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_rows{flex-direction:column;gap:8px;margin:12px 0 0;padding:0;list-style:none;display:flex}.hYEBUa_rowCard{border:1px solid var(--dsw-alias-border-l2);border-radius:12px;flex-direction:column;gap:12px;padding:12px 14px;display:flex}.hYEBUa_rowHead{align-items:baseline;gap:8px;display:flex}.hYEBUa_rowName{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.hYEBUa_rowTag{border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary);border-radius:4px;flex:none;padding:1px 6px;font-size:11px;line-height:16px}.hYEBUa_compatSummary{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.hYEBUa_presetRow,.hYEBUa_actions{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_fieldLabel{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:500;line-height:18px}.hYEBUa_primaryButton,.hYEBUa_secondaryButton{box-sizing:border-box;height:36px;font:inherit;cursor:pointer;border-radius:18px;justify-content:center;align-items:center;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.hYEBUa_primaryButton{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border:none}.hYEBUa_primaryButton:hover:not(:disabled){background:var(--dsw-alias-button-primary-hover)}.hYEBUa_secondaryButton{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);background:0 0}.hYEBUa_secondaryButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.hYEBUa_primaryButton:disabled,.hYEBUa_secondaryButton:disabled,.hYEBUa_linkButton:disabled,.hYEBUa_input:disabled{opacity:.4;cursor:default}.hYEBUa_primaryButton:focus-visible,.hYEBUa_secondaryButton:focus-visible,.hYEBUa_linkButton:focus-visible,.hYEBUa_input:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}.hYEBUa_linkButton{box-sizing:border-box;height:28px;color:var(--dsw-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:none;border-radius:14px;align-items:center;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_linkButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.hYEBUa_modelEntry{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:8px;padding:10px 0;display:flex}.hYEBUa_modelHead{flex-wrap:wrap;align-items:baseline;gap:8px;display:flex}.hYEBUa_modelId{font-size:13px;font-weight:500;line-height:20px}.hYEBUa_modelName{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}.hYEBUa_levels{flex-wrap:wrap;gap:10px 14px;display:flex}.hYEBUa_level{align-items:center;gap:6px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_wireRow{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_input,.hYEBUa_selectInput{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-module-platform);height:32px;color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;padding:0 10px;font-size:13px}.hYEBUa_wireInput{width:7em}.hYEBUa_offGroup{flex-direction:column;gap:6px;display:flex}.hYEBUa_advanced{border-top:1px solid var(--dsw-alias-border-l2);padding-top:8px}.hYEBUa_advanced summary{cursor:pointer;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}.hYEBUa_advancedBody{flex-direction:column;gap:10px;padding-top:10px;display:flex}.hYEBUa_check{align-items:flex-start;gap:8px;font-size:12px;line-height:18px;display:flex}.hYEBUa_footer{color:var(--dsw-alias-label-tertiary);opacity:.7;margin:16px 0 0;font-size:11px;line-height:16px}";
 		const cssTagId = "dsh-plugin-effort-declare/effort-declare.module.css";
 		var effort_declare_module_css_default = {
 			"actions": "hYEBUa_actions",
@@ -634,6 +729,7 @@ window.__ModuleLoader__.load({
 			"compatSummary": "hYEBUa_compatSummary",
 			"error": "hYEBUa_error",
 			"fieldLabel": "hYEBUa_fieldLabel",
+			"footer": "hYEBUa_footer",
 			"input": "hYEBUa_input",
 			"intro": "hYEBUa_intro",
 			"level": "hYEBUa_level",
@@ -999,40 +1095,75 @@ window.__ModuleLoader__.load({
 			const [notices, setNotices] = (0, react.useState)({});
 			const generationRef = (0, react.useRef)(0);
 			const draftsRef = (0, react.useRef)(drafts);
+			const echoedRevisionRef = (0, react.useRef)(void 0);
+			const pendingRevisionRef = (0, react.useRef)(void 0);
+			const busyRouteRef = (0, react.useRef)(null);
+			const abortRef = (0, react.useRef)(null);
 			draftsRef.current = drafts;
-			const reload = (0, react.useCallback)((preserveDirty) => {
+			const applyDrafts = (next) => {
+				const resolved = typeof next === "function" ? next(draftsRef.current) : next;
+				draftsRef.current = resolved;
+				setDrafts(resolved);
+			};
+			const snapshotMode = () => describe === void 0 || describe.getSnapshot().status === "idle" ? "ensure" : "snapshot";
+			const beginGeneration = () => {
+				abortRef.current?.abort();
+				const abort = new AbortController();
+				abortRef.current = abort;
+				return {
+					generation: nextGeneration(generationRef),
+					signal: abort.signal
+				};
+			};
+			const failGeneration = (generation, failure) => {
+				if (!generationIsCurrent(generationRef, generation)) return;
+				setStatus("error");
+				setError(failure instanceof Error ? failure.message : t("loadError"));
+			};
+			const settleReload = (generation, preserveDirty, result) => {
+				if (!generationIsCurrent(generationRef, generation)) return;
+				setWritable(result.writable);
+				setFormats(result.formats);
+				if (result.error !== void 0) {
+					setStatus("error");
+					setError(result.error);
+					return;
+				}
+				const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty });
+				applyDrafts(merged.drafts);
+				setNotices((current) => foldReloadNotices(current, {
+					conflicted: merged.conflicted,
+					conflictNotice: {
+						kind: "conflict",
+						text: t("dirtyConflict")
+					},
+					liveProviders: merged.drafts.map((draft) => draft.provider)
+				}));
+				setStatus("ready");
+			};
+			const loadSnapshotThenSettle = async (generation, preserveDirty) => {
+				if (api === void 0 || describe === void 0 || schema === void 0) return;
+				if (!generationIsCurrent(generationRef, generation)) return;
+				try {
+					const result = await loadDrafts(api, describe, schema, "snapshot");
+					settleReload(generation, preserveDirty, result);
+				} catch (failure) {
+					failGeneration(generation, failure);
+				}
+			};
+			const reload = (0, react.useCallback)((preserveDirty, mode = "ensure") => {
 				if (api === void 0 || describe === void 0 || schema === void 0) {
 					setStatus("error");
 					setError(t("loadError"));
 					return;
 				}
-				const generation = nextGeneration(generationRef);
+				const { generation } = beginGeneration();
 				if (draftsRef.current.length === 0) setStatus("loading");
 				setError("");
-				loadDrafts(api, describe, schema).then((result) => {
-					if (!generationIsCurrent(generationRef, generation)) return;
-					setWritable(result.writable);
-					setFormats(result.formats);
-					if (result.error !== void 0) {
-						setStatus("error");
-						setError(result.error);
-						return;
-					}
-					const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty });
-					setDrafts(merged.drafts);
-					if (merged.conflicted.length > 0) setNotices((current) => {
-						const next = { ...current };
-						for (const provider of merged.conflicted) next[provider] = {
-							kind: "conflict",
-							text: t("dirtyConflict")
-						};
-						return next;
-					});
-					setStatus("ready");
+				loadDrafts(api, describe, schema, mode).then((result) => {
+					settleReload(generation, preserveDirty, result);
 				}, (failure) => {
-					if (!generationIsCurrent(generationRef, generation)) return;
-					setStatus("error");
-					setError(failure instanceof Error ? failure.message : t("loadError"));
+					failGeneration(generation, failure);
 				});
 			}, [
 				api,
@@ -1040,22 +1171,61 @@ window.__ModuleLoader__.load({
 				schema,
 				t
 			]);
+			const refreshAtRevision = (0, react.useCallback)((revision, preserveDirty) => {
+				if (api === void 0 || describe === void 0 || schema === void 0) return;
+				const { generation, signal } = beginGeneration();
+				if (draftsRef.current.length === 0) setStatus("loading");
+				setError("");
+				waitForNamespaceRevision(describe, LLM_PI_AI_NS, revision, signal).then((outcome) => {
+					if (outcome === "aborted" || !generationIsCurrent(generationRef, generation)) return;
+					return loadSnapshotThenSettle(generation, preserveDirty);
+				}, (failure) => {
+					failGeneration(generation, failure);
+				});
+			}, [
+				api,
+				describe,
+				schema,
+				t
+			]);
+			const flushPendingSettings = (refresh) => {
+				const pending = pendingRevisionRef.current;
+				pendingRevisionRef.current = void 0;
+				if (pending === void 0) return;
+				if (isOwnDocumentEcho(echoedRevisionRef.current, pending)) return;
+				refresh(pending, true);
+			};
 			(0, react.useEffect)(() => {
-				reload(false);
+				reload(false, "ensure");
 			}, [reload]);
+			(0, react.useEffect)(() => () => {
+				abortRef.current?.abort();
+				nextGeneration(generationRef);
+			}, []);
 			(0, react.useEffect)(() => {
 				if (props.subscribeInvalidate === void 0) return void 0;
-				return props.subscribeInvalidate((source) => {
-					if (source === "writable") {
+				return props.subscribeInvalidate((event) => {
+					if (event.source === "writable") {
 						const view = describe?.getSnapshot().view;
 						if (view !== void 0) setWritable(view.writable);
 						return;
 					}
-					if (source === "settings" || source === "directory") reload(true);
+					if (event.source === "settings") {
+						if (busyRouteRef.current !== null) {
+							pendingRevisionRef.current = event.revision;
+							return;
+						}
+						if (isOwnDocumentEcho(echoedRevisionRef.current, event.revision)) return;
+						refreshAtRevision(event.revision, true);
+						return;
+					}
+					if (event.source === "directory") reload(true, snapshotMode());
+					if (event.source === "reset") reload(true, "ensure");
 				});
 			}, [
 				describe,
 				props.subscribeInvalidate,
+				refreshAtRevision,
 				reload
 			]);
 			const patchNotice = (provider, notice) => {
@@ -1068,7 +1238,7 @@ window.__ModuleLoader__.load({
 			};
 			const save = async (draft) => {
 				if (api === void 0 || describe === void 0 || schema === void 0) return;
-				if (status === "loading" || busyRoute !== null) {
+				if (status === "loading" || busyRouteRef.current !== null) {
 					patchNotice(draft.provider, {
 						kind: "error",
 						text: t("saveBusy")
@@ -1083,6 +1253,7 @@ window.__ModuleLoader__.load({
 					});
 					return;
 				}
+				busyRouteRef.current = draft.provider;
 				setBusyRoute(draft.provider);
 				patchNotice(draft.provider, void 0);
 				try {
@@ -1094,7 +1265,7 @@ window.__ModuleLoader__.load({
 						afterCompat: draft.compat
 					});
 					if (ops.length === 0) {
-						setDrafts((current) => current.map((row) => row.provider === draft.provider ? alignDraft(row) : row));
+						applyDrafts((current) => current.map((row) => row.provider === draft.provider ? alignDraft(row) : row));
 						return;
 					}
 					const willWriteCompat = ops.some((op) => op.path.length > draft.settingsPath.length && op.path[draft.settingsPath.length] === "compat");
@@ -1128,12 +1299,21 @@ window.__ModuleLoader__.load({
 							kind: conflict ? "conflict" : "error",
 							text: conflict ? t("conflict") : response.result.error.message
 						});
-						if (conflict) reload(true);
+						if (conflict) {
+							const { generation, signal } = beginGeneration();
+							waitForNamespaceRevisionChange(describe, LLM_PI_AI_NS, draft.revision, signal).then((outcome) => {
+								if (outcome === "aborted" || !generationIsCurrent(generationRef, generation)) return;
+								return loadSnapshotThenSettle(generation, true);
+							}, (failure) => {
+								failGeneration(generation, failure);
+							});
+						}
 						return;
 					}
 					const view = response.result.value;
+					echoedRevisionRef.current = view.revision;
 					describe.acceptView(view);
-					setDrafts((current) => applySaveSuccess(current, draft.provider, {
+					applyDrafts(applySaveSuccess(draftsRef.current, draft.provider, {
 						user: view.user ?? {},
 						revision: view.revision
 					}));
@@ -1147,7 +1327,9 @@ window.__ModuleLoader__.load({
 						text: failure instanceof Error ? failure.message : t("loadError")
 					});
 				} finally {
+					busyRouteRef.current = null;
 					setBusyRoute(null);
+					flushPendingSettings(refreshAtRevision);
 				}
 			};
 			const showLoading = status === "loading" && drafts.length === 0;
@@ -1182,7 +1364,7 @@ window.__ModuleLoader__.load({
 						type: "button",
 						className: effort_declare_module_css_default.secondaryButton,
 						onClick: () => {
-							reload(true);
+							reload(true, snapshotMode());
 						},
 						children: t("reload")
 					}) : null,
@@ -1205,21 +1387,25 @@ window.__ModuleLoader__.load({
 							t,
 							onChange: (next) => {
 								patchNotice(next.provider, void 0);
-								setDrafts((current) => current.map((row) => row.provider === next.provider ? next : row));
+								applyDrafts((current) => current.map((row) => row.provider === next.provider ? next : row));
 							},
 							onSave: (next) => {
 								save(next);
 							},
 							onCancel: (next) => {
 								patchNotice(next.provider, void 0);
-								setDrafts((current) => current.map((row) => row.provider === next.provider ? {
+								applyDrafts((current) => current.map((row) => row.provider === next.provider ? {
 									...row,
 									models: cloneModels(row.originalModels),
 									compat: cloneObject(row.originalCompat)
 								} : row));
 							}
 						}, draft.provider))
-					}) : null
+					}) : null,
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: effort_declare_module_css_default.footer,
+						children: PLUGIN_FOOTER_TEXT
+					})
 				]
 			});
 		}
@@ -1357,22 +1543,25 @@ window.__ModuleLoader__.load({
 			const describe = ctx.settingsScope.describe();
 			const invalidation = /* @__PURE__ */ new Set();
 			ctx.effect(() => {
-				const emit = (source) => {
-					for (const listener of invalidation) listener(source);
+				const emit = (event) => {
+					for (const listener of invalidation) listener(event);
 				};
 				const disposers = [
 					describe.subscribe(() => {
-						emit("writable");
+						emit({ source: "writable" });
 					}),
-					ctx.remote.$on("settings/document-updated", (ns) => {
+					ctx.remote.$on("settings/document-updated", (ns, revision) => {
 						if (ns !== "llm-pi-ai") return;
-						emit("settings");
+						emit({
+							source: "settings",
+							revision
+						});
 					}),
 					ctx.remote.$on("llm/adapters-updated", () => {
-						emit("directory");
+						emit({ source: "directory" });
 					}),
 					ctx.on("connection/reset", () => {
-						emit("directory");
+						emit({ source: "reset" });
 					})
 				];
 				return () => {