dsh-ntr 0.2.1 → 0.3.1

package/lib/client.js

@@ -49,6 +49,12 @@ window.__ModuleLoader__.load({
 		const MAX_WATCHED = 6;
 		/** Raw JSON budget for one event block; the cut is marked. */
 		const RAW_MAX = 256e3;
+		/**
+		* How long a fetched update state stays fresh. The settings panel asks on every
+		* mount; without this, every open would hit the registry. A forced check (the
+		* card's own button) always goes out.
+		*/
+		const PLUGIN_UPDATE_TTL_MS = 6e5;
 		/** Pretty-printed JSON of an agent message (never throws, cuts only at {@link RAW_MAX} with a marker). */
 		function jsonText(value) {
 			let text;
@@ -262,6 +268,14 @@ window.__ModuleLoader__.load({
 				defaultCommand: "opencode",
 				defaultArgs: ["acp"]
 			},
+			{
+				id: "cursor",
+				name: "Cursor CLI",
+				description: "Cursor CLI — run as `agent acp` over stdio (legacy alias `cursor-agent acp`)",
+				detected: false,
+				defaultCommand: "agent",
+				defaultArgs: ["acp"]
+			},
 			{
 				id: "qwen",
 				name: "Qwen Code",
@@ -308,6 +322,8 @@ window.__ModuleLoader__.load({
 				blocks: [],
 				permissions: [],
 				busy: false,
+				logs: [],
+				logUnread: 0,
 				detectedAgents: [...DEFAULT_KNOWN_PRESETS],
 				detecting: false,
 				modelCatalogs: {},
@@ -329,6 +345,8 @@ window.__ModuleLoader__.load({
 			};
 			listeners = /* @__PURE__ */ new Set();
 			source;
+			/** Monotonic id source for {@link AcpLogEntry}s (never reset by `clearLogs`). */
+			logSeq = 0;
 			lastSeq = /* @__PURE__ */ new Map();
 			/** Sessions with a finalized turn (dedups the cancel-fallback + late real turn/end pair). */
 			openTurns = /* @__PURE__ */ new Set();
@@ -377,6 +395,22 @@ window.__ModuleLoader__.load({
 			cachedModelReads = /* @__PURE__ */ new Set();
 			/** Counts behind the last successful explicit re-detect, so a locale switch can re-render its summary. */
 			detectCounts;
+			/** When {@link UiState.pluginUpdate} was last read from the host (epoch ms). */
+			pluginUpdateFetchedAt = 0;
+			/**
+			* The shared in-flight `plugin/update-check`. The settings section mounts
+			* twice (both entries) and the update popover asks too; without this, two
+			* mounts in the same tick each fire their own registry read.
+			*/
+			pluginUpdateInflight;
+			/** Re-entry guard for `plugin/update-apply` (a double click is one install). */
+			pluginUpdateApplying = false;
+			/**
+			* Update read generation. An apply bumps it so a check that was already in
+			* flight (started before the install) cannot land afterwards and overwrite
+			* the install's verdict with the pre-install `available`.
+			*/
+			pluginUpdateGeneration = 0;
 			constructor(rpc, locale) {
 				this.rpc = rpc;
 				this.locale = locale;
@@ -399,6 +433,23 @@ window.__ModuleLoader__.load({
 				for (const listener of [...this.listeners]) listener();
 			}
 			/**
+			* Build the log patch for one line. Does NOT mutate: the caller merges it
+			* into the single `mutate` call it was already making for the same event.
+			*/
+			logPatch(level, text, agentId) {
+				const entry = {
+					id: ++this.logSeq,
+					at: Date.now(),
+					level,
+					text,
+					...agentId === void 0 ? {} : { agentId }
+				};
+				return {
+					logs: [...this.state.logs, entry].slice(-200),
+					logUnread: this.state.logUnread + 1
+				};
+			}
+			/**
 			* Live `session/update` frames waiting to be folded. Agents stream at token
 			* granularity — hundreds of frames a second with usage ticks interleaved —
 			* and folding plus notifying listeners per frame re-rendered every store
@@ -499,14 +550,15 @@ window.__ModuleLoader__.load({
 			/** Snapshot refresh used on panel open and after a stream outage. */
 			async resync() {
 				try {
-					const [{ agents }, { sessions }, defaultAgentInfo, detectResult, presetResult, tagHaloResult, deadlinesResult] = await Promise.all([
+					const [{ agents }, { sessions }, defaultAgentInfo, detectResult, presetResult, tagHaloResult, deadlinesResult, versionResult] = await Promise.all([
 						this.call("agents/list"),
 						this.call("sessions/list"),
 						this.call("default/agent").catch(() => ({})),
 						this.call("agents/detect").catch(() => null),
 						this.call("preset/status").catch(() => null),
 						this.call("ui/tag-halo").catch(() => ({ halo: { ...DEFAULT_TAG_HALO } })),
-						this.call("ui/approval-deadlines").catch(() => ({ deadlines: void 0 }))
+						this.call("ui/approval-deadlines").catch(() => ({ deadlines: void 0 })),
+						this.call("plugin/version").catch(() => null)
 					]);
 					const detectedAgents = detectResult && detectResult.agents.length > 0 ? detectResult.agents : this.state.detectedAgents.length > 0 ? this.state.detectedAgents : [...DEFAULT_KNOWN_PRESETS];
 					this.mutate({
@@ -517,7 +569,8 @@ window.__ModuleLoader__.load({
 						detectedAgents,
 						preset: presetResult?.preset ?? void 0,
 						tagHalo: tagHaloResult?.halo ?? { ...DEFAULT_TAG_HALO },
-						approvalDeadlines: deadlinesResult.deadlines
+						approvalDeadlines: deadlinesResult.deadlines,
+						pluginVersion: versionResult?.version !== void 0 && versionResult.version !== "" ? versionResult.version : void 0
 					});
 					const active = this.state.activeSessionId ?? sessions[0]?.sessionId;
 					if (active !== void 0) await this.loadTranscript(active);
@@ -525,6 +578,89 @@ window.__ModuleLoader__.load({
 					this.mutate({ notice: String(error instanceof Error ? error.message : error) });
 				}
 			}
+			/**
+			* Read the plugin's update state (`plugin/update-check`). Throttled to ten
+			* minutes unless `force`: the settings panel asks on mount, and every
+			* remount must not hit the registry.
+			*
+			* An older host serves no such endpoint (`unknown endpoint`). That is a
+			* normal degradation, not an error worth a notice: the answer is `undefined`
+			* and the panel simply keeps its update entry hidden.
+			*/
+			async checkPluginUpdate(force = false) {
+				if (this.pluginUpdateInflight !== void 0) return this.pluginUpdateInflight;
+				const current = this.state.pluginUpdate;
+				if (!force && current !== void 0 && Date.now() - this.pluginUpdateFetchedAt < PLUGIN_UPDATE_TTL_MS) return current;
+				const generation = this.pluginUpdateGeneration;
+				const inflight = this.readPluginUpdate(generation);
+				this.pluginUpdateInflight = inflight;
+				try {
+					return await inflight;
+				} finally {
+					this.pluginUpdateInflight = void 0;
+				}
+			}
+			async readPluginUpdate(generation) {
+				try {
+					const pluginUpdate = await this.call("plugin/update-check");
+					if (generation !== this.pluginUpdateGeneration) return void 0;
+					this.pluginUpdateFetchedAt = Date.now();
+					this.mutate({ pluginUpdate });
+					return pluginUpdate;
+				} catch {
+					return;
+				}
+			}
+			/**
+			* Install one exact version (`plugin/update-apply`). The status flips to
+			* `applying` first so the badge answers the click; the host's answer then
+			* becomes the state.
+			*
+			* A failed call does NOT prove the install did not happen: on an HMR host
+			* the update uninstalls the plugin before reinstalling it, which can cut the
+			* response. Whatever the error, the disk may already carry the new version,
+			* so the state becomes `restart-required` (the one neutral verdict for "the
+			* running code is not the disk's") with `installed` dropped (unknown, not a
+			* fact to display) and the notice asks for a reload rather than restoring
+			* `available` and pretending nothing changed.
+			*/
+			async applyPluginUpdate(version) {
+				if (this.pluginUpdateApplying) return void 0;
+				this.pluginUpdateApplying = true;
+				this.pluginUpdateGeneration += 1;
+				const previous = this.state.pluginUpdate;
+				if (previous !== void 0) this.mutate({ pluginUpdate: {
+					...previous,
+					status: "applying"
+				} });
+				try {
+					const pluginUpdate = await this.call("plugin/update-apply", { version });
+					this.pluginUpdateFetchedAt = Date.now();
+					this.mutate({ pluginUpdate });
+					return pluginUpdate;
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					const interrupted = previous !== void 0 ? {
+						...previous,
+						status: "restart-required",
+						installed: void 0,
+						message
+					} : {
+						status: "restart-required",
+						current: this.state.pluginVersion ?? "?",
+						message
+					};
+					this.pluginUpdateFetchedAt = 0;
+					this.mutate({
+						pluginUpdate: interrupted,
+						notice: this.locale("更新请求已中断；请刷新页面确认当前版本。", "The update request was interrupted. Reload the page to confirm the installed version.")
+					});
+					return;
+				} finally {
+					this.pluginUpdateGeneration += 1;
+					this.pluginUpdateApplying = false;
+				}
+			}
 			async detectAgents() {
 				this.mutate({ detecting: true });
 				try {
@@ -1364,13 +1500,25 @@ window.__ModuleLoader__.load({
 			clearNotice() {
 				this.mutate({ notice: void 0 });
 			}
+			/** Drop every retained runtime-log line (the unread counter restarts too). */
+			clearLogs() {
+				this.mutate({
+					logs: [],
+					logUnread: 0
+				});
+			}
+			/** The user looked at the log: clear the unread badge. */
+			markLogsRead() {
+				if (this.state.logUnread === 0) return;
+				this.mutate({ logUnread: 0 });
+			}
 			flashError(error) {
 				this.mutate({ notice: error instanceof Error ? error.message : String(error) });
 			}
 			applyEvent(event) {
 				switch (event.type) {
 					case "agent/notice":
-						this.mutate({ notice: event.text });
+						this.mutate(this.logPatch(event.level, event.text, event.agentId));
 						return Promise.resolve();
 					case "agent/status":
 						if (event.agent !== void 0) {
@@ -1395,6 +1543,7 @@ window.__ModuleLoader__.load({
 						return Promise.resolve();
 					}
 					case "session/closed": {
+						const closingSession = this.state.sessions.find((s) => s.sessionId === event.sessionId);
 						const sessions = this.state.sessions.filter((s) => s.sessionId !== event.sessionId);
 						const active = this.state.activeSessionId === event.sessionId ? sessions[0]?.sessionId : this.state.activeSessionId;
 						this.openTurns.delete(event.sessionId);
@@ -1407,7 +1556,7 @@ window.__ModuleLoader__.load({
 							chatTranscripts: closedTranscripts,
 							...chatSessions.length !== this.state.chatSessions.length ? { chatSessions } : {},
 							permissions: this.state.permissions.filter((p) => p.sessionId !== event.sessionId),
-							...event.reason === "agent-died" ? { notice: this.locale("会话因 agent 进程退出而终止", "session ended: agent process died") } : {}
+							...event.reason === "agent-died" ? this.logPatch("error", this.locale("会话因 agent 进程退出而终止", "session ended: agent process died"), closingSession?.agentId) : {}
 						});
 						return Promise.resolve();
 					}
@@ -1418,12 +1567,18 @@ window.__ModuleLoader__.load({
 							...s,
 							released: true
 						} : s) : this.state.chatSessions;
+						const cause = event.cause ?? "died";
+						let log = {};
+						if (cause === "workspace") log = this.logPatch("info", this.locale("agent 为切换工作区重启，会话已挂起；再次发送消息将自动恢复。", "agent restarted for its workspace; the session is paused and will resume on your next message."), event.session.agentId);
+						else if (cause === "resume-failed") log = this.logPatch("error", this.locale("会话恢复失败；再次发送消息将重试恢复。", "session resume failed; your next message will retry it."), event.session.agentId);
+						else if (cause === "stalled") log = this.logPatch("error", this.locale("agent 未响应卡死的回合，会话已挂起；再次发送消息将自动恢复。", "agent did not acknowledge the stalled turn; the session is paused and will resume on your next message."), event.session.agentId);
+						else if (cause === "died") log = this.logPatch("error", this.locale("agent 进程已退出，会话已挂起；再次发送消息将自动恢复。", "agent process died; the session is paused and will resume on your next message."), event.session.agentId);
 						this.mutate({
 							sessions,
 							...chatSessions !== this.state.chatSessions ? { chatSessions } : {},
 							permissions: this.state.permissions.filter((p) => p.sessionId !== event.sessionId),
 							...this.watchedSessionPatch(event.sessionId, event.session),
-							notice: this.locale("agent 进程已退出，会话已挂起；再次发送消息将自动恢复。", "agent process died; the session is paused and will resume on your next message.")
+							...log
 						});
 						return Promise.resolve();
 					}
@@ -2638,7 +2793,7 @@ window.__ModuleLoader__.load({
 }
 .dwa-page-header { display: flex; align-items: center; justify-content: space-between; gap: 16px; margin-bottom: 28px; }
 .dwa-page-heading { min-width: 0; }
-.dwa-page-title { margin: 0; font-size: 20px; line-height: 1.35; font-weight: 550; letter-spacing: -0.02em; }
+.dwa-page-title { margin: 0; font-size: 20px; line-height: 1.35; font-weight: 550; letter-spacing: -0.02em; display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
 .dwa-page-description { margin: 5px 0 0; color: var(--ntr-muted); font-size: var(--ntr-font-sm); }
 .dwa-btn {
   min-height: 32px; box-sizing: border-box; font: inherit; border-radius: var(--ntr-radius-sm);
@@ -2670,6 +2825,20 @@ window.__ModuleLoader__.load({
 .dwa-badge-success { background: var(--dsw-alias-state-success-tertiary, #dcfce7); color: var(--ntr-success); }
 .dwa-badge-warn { background: var(--dsw-alias-state-warn-tertiary, #fef3c7); color: var(--ntr-warn); }
 .dwa-badge-info { background: var(--dsw-alias-state-business-tertiary, #dbeafe); color: var(--dsw-alias-state-business-primary, #2563eb); }
+/* The update badge is a button (it expands the update card): strip the
+   browser's default button chrome, keep the badge look. */
+.dwa-update-badge { border: 0; font-family: inherit; cursor: pointer; }
+.dwa-update-badge:hover { opacity: 0.85; }
+/* The version badge doubles as the update entry: same badge look, no chrome. */
+.dwa-version-btn { border: 0; font-family: inherit; cursor: pointer; }
+.dwa-version-btn:hover { opacity: 0.85; }
+.dwa-version { font-family: var(--ds-font-family-code, monospace); }
+/* The update card sits between the page header and the permission mirror. */
+.dwa-update-card { margin-bottom: 16px; }
+.dwa-update-summary { display: flex; align-items: baseline; gap: 8px; flex-wrap: wrap; font-weight: 550; }
+.dwa-update-copy { margin: 6px 0 0; color: var(--ntr-muted); font-size: var(--ntr-font-xs); }
+.dwa-update-message { margin: 6px 0 0; color: var(--ntr-muted); font-size: var(--ntr-font-xs); white-space: pre-wrap; overflow-wrap: anywhere; }
+.dwa-update-actions { margin-top: 10px; }
 .dwa-dot { width: 7px; height: 7px; border-radius: 50%; display: inline-block; flex-shrink: 0; }
 .dwa-agent-list { display: flex; flex-direction: column; border-top: var(--ntr-line); }
 .dwa-agent-card { border-bottom: var(--ntr-line); min-width: 0; }
@@ -2792,6 +2961,17 @@ window.__ModuleLoader__.load({
 .dwa-deadline-flag { margin-top: 4px; font-size: var(--ntr-font-xs); font-weight: 550; color: var(--ntr-warn); }
 .dwa-deadline-warn { margin-top: 10px; padding: 9px 12px; border-left: 3px solid var(--dsw-alias-state-warn-primary, #d97706); background: var(--dsw-alias-state-warn-secondary, #fffbeb); border-radius: var(--ntr-radius-sm); font-size: var(--ntr-font-xs); line-height: 1.55; }
 .dwa-deadline-reset { display: flex; justify-content: flex-end; margin-top: 8px; }
+/* Runtime log: one bounded list, newest first. The time column never wraps;
+   the message is the only cell that may break anywhere. */
+.dwa-log-list { list-style: none; margin: 0; padding: 0; border: var(--ntr-line); border-radius: var(--ntr-radius); overflow: hidden; }
+.dwa-log-row { display: flex; align-items: baseline; gap: 8px; padding: 6px 10px; font-size: var(--ntr-font-sm); border-top: var(--ntr-line); min-width: 0; }
+.dwa-log-row:first-child { border-top: 0; }
+.dwa-log-row.is-error { background: var(--dsw-alias-state-error-tertiary, #fef2f2); }
+.dwa-log-time { color: var(--ntr-muted); white-space: nowrap; }
+.dwa-log-text { flex: 1; min-width: 0; overflow-wrap: anywhere; }
+.dwa-log-dot { width: 6px; height: 6px; border-radius: 50%; background: var(--ntr-danger); display: inline-block; margin-left: 6px; }
+.dwa-log-level.is-info { background: var(--dsw-alias-state-business-tertiary, #dbeafe); color: var(--dsw-alias-state-business-primary, #2563eb); }
+.dwa-log-level.is-error { background: var(--dsw-alias-state-error-tertiary, #fef2f2); color: var(--ntr-danger); }
 @media (max-width: 640px) {
   .dwa-root { padding: 20px 16px; }
 }
@@ -3320,6 +3500,152 @@ window.__ModuleLoader__.load({
 				})]
 			});
 		}
+		/**
+		* Local wall-clock `HH:MM:SS` for one runtime-log line. Hand-built on purpose:
+		* `toLocaleTimeString` may drop seconds or pick a 12-hour clock depending on
+		* the browser locale, which makes the column ragged and ambiguous.
+		*/
+		function logClock(at) {
+			const date = new Date(at);
+			return [
+				date.getHours(),
+				date.getMinutes(),
+				date.getSeconds()
+			].map((value) => String(value).padStart(2, "0")).join(":");
+		}
+		/** The states that carry an update badge next to the version badge. */
+		function updateBadgeText(update, acp) {
+			if (update.status === "available") return acp.label(`可更新 v${update.latest ?? update.current}`, `Update v${update.latest ?? update.current}`);
+			if (update.status === "applying") return acp.label("更新中…", "Updating…");
+			if (update.status === "applied") {
+				const installed = update.installed ?? update.latest ?? update.current;
+				return acp.label(`已更新 v${installed}`, `Updated v${installed}`);
+			}
+			if (update.status === "restart-required") {
+				if (update.installed === void 0) return void 0;
+				return acp.label(`待重启 v${update.installed}`, `Restart for v${update.installed}`);
+			}
+		}
+		/**
+		* The version badge's update companion. Every badge is a button, `applying`
+		* included: the card is where the install's outcome is read, so the running
+		* install must be able to open it too. States without anything to act on get
+		* no badge at all — the version badge itself still opens the card.
+		*/
+		function PluginUpdateBadge(props) {
+			const { acp, update, open, onToggle } = props;
+			const text = updateBadgeText(update, acp);
+			if (text === void 0) return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: "dwa-badge dwa-badge-info dwa-update-badge",
+				"aria-expanded": open,
+				"aria-controls": "ntr-plugin-update-card",
+				onClick: onToggle,
+				children: text
+			});
+		}
+		/**
+		* The update card. In-page, no dialog: the settings page already owns the one
+		* action (install the exact version the host reported), and a modal on top of
+		* a settings section would hide the version it is updating.
+		*
+		* The copy stays to one line per state (constraint 33); the host's raw error
+		* (`message`) is the only long text, and it wraps on its own line so a stack
+		* trace or a registry error is readable without stretching the card.
+		*/
+		function PluginUpdateCard(props) {
+			const { acp, update, onClose } = props;
+			const applying = update.status === "applying";
+			const latest = update.latest ?? update.current;
+			const onDisk = update.installed !== void 0 && update.installed !== update.current ? update.installed : void 0;
+			const published = update.publishedAt !== void 0 && !Number.isNaN(new Date(update.publishedAt).getTime()) ? new Date(update.publishedAt).toLocaleDateString() : void 0;
+			const copy = update.status === "available" ? acp.label("更新会卸载并重装插件，之后可能需要重启 DSH。", "Updating uninstalls and reinstalls the plugin, and may require restarting DSH.") : update.status === "applied" ? acp.label("已应用，刷新页面即可使用新版本。", "Applied. Reload the page to use the new version.") : update.status === "restart-required" ? update.installed !== void 0 ? acp.label(`磁盘已是 v${update.installed}，重启 DSH 后生效（桌面 App 退出重开；命令行重启 dsh web）。`, `On disk v${update.installed}. Restart DSH to apply (quit and reopen the app, or restart dsh web).`) : acp.label("更新可能已完成，请刷新页面确认当前版本。", "The update may already be complete. Refresh the page to confirm the current version.") : update.status === "busy" ? acp.label("有进行中的对话，结束后才能更新。", "Finish the running conversation before updating.") : update.status === "failed" ? acp.label("更新失败。", "Update failed.") : update.status === "current" ? acp.label("已是最新版本。", "Up to date.") : update.status === "source-install" ? acp.label("源码或本地安装，无法通过 registry 更新。", "Source or local install; update it through its own checkout.") : update.status === "managed" ? acp.label("此安装由宿主管理，不能在这里更新。", "This install is managed by the host and cannot be updated here.") : void 0;
+			const showMessage = (update.status === "failed" || update.status === "busy" || update.status === "managed") && update.message !== void 0;
+			const apply = async () => {
+				if (update.latest === void 0) return;
+				try {
+					await acp.applyPluginUpdate(update.latest);
+				} catch {}
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				id: "ntr-plugin-update-card",
+				className: "dwa-card dwa-update-card",
+				role: "group",
+				"aria-label": acp.label("插件更新", "Plugin update"),
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dwa-update-summary",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: acp.label(`当前 v${update.current}`, `Current v${update.current}`) }),
+							onDisk !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "dwa-hint",
+								children: acp.label(`磁盘 v${onDisk}`, `On disk v${onDisk}`)
+							}),
+							update.latest !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									"aria-hidden": "true",
+									children: "→"
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: acp.label(`最新 v${latest}`, `Latest v${latest}`) }),
+								published !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dwa-hint",
+									children: published
+								})
+							] })
+						]
+					}),
+					copy !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dwa-update-copy",
+						children: copy
+					}),
+					showMessage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "dwa-update-message",
+						children: update.message
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dwa-row-actions dwa-update-actions",
+						children: [
+							update.status === "available" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dwa-btn dwa-btn-primary",
+								onClick: () => {
+									apply();
+								},
+								children: acp.label("更新", "Update")
+							}),
+							applying && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dwa-btn dwa-btn-primary",
+								disabled: true,
+								children: acp.label("正在更新…", "Updating…")
+							}),
+							update.status !== "applying" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dwa-btn",
+								onClick: onClose,
+								children: acp.label("关闭", "Close")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dwa-btn dwa-btn-quiet",
+								disabled: applying,
+								onClick: () => void acp.checkPluginUpdate(true),
+								children: acp.label("重新检查", "Check again")
+							})
+						]
+					})
+				]
+			});
+		}
+		/**
+		* The card is drawn for every state a host can report about this install,
+		* except the two where there is no install to talk about at all.
+		*/
+		function updateCardVisible(update, open) {
+			if (update === void 0 || !open) return false;
+			return update.status !== "unsupported" && update.status !== "not-installed";
+		}
 		function AcpSettingsSection(props) {
 			const acp = props.acp;
 			ensureStyle();
@@ -3328,6 +3654,17 @@ window.__ModuleLoader__.load({
 			const [page, setPage] = (0, react.useState)("agents");
 			const [addOpen, setAddOpen] = (0, react.useState)(false);
 			const [addTarget, setAddTarget] = (0, react.useState)(void 0);
+			const [updateOpen, setUpdateOpen] = (0, react.useState)(false);
+			(0, react.useEffect)(() => {
+				acp.checkPluginUpdate();
+			}, [acp]);
+			(0, react.useEffect)(() => {
+				if (page === "logs" && ui.logUnread > 0) acp.markLogsRead();
+			}, [
+				acp,
+				page,
+				ui.logUnread
+			]);
 			const { configured, available } = partitionAgents(ui.detectedAgents, ui.agents);
 			const selected = addTarget ?? available[0] ?? NEW_AGENT_SEED;
 			const openAdd = () => {
@@ -3335,6 +3672,9 @@ window.__ModuleLoader__.load({
 				setPage("add");
 			};
 			const presetProblem = ui.preset !== void 0 && (!ui.preset.installed || ui.preset.problem !== void 0);
+			const update = ui.pluginUpdate;
+			const versionTitle = update?.status === "source-install" ? acp.label("源码或本地安装，无法通过 registry 更新。", "Source or local install; update it through its own checkout.") : void 0;
+			const versionOpensUpdate = update !== void 0 && update.status !== "unsupported" && update.status !== "not-installed";
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dwa-root",
 				children: [
@@ -3342,9 +3682,31 @@ window.__ModuleLoader__.load({
 						className: "dwa-page-header",
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dwa-page-heading",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("h2", {
 								className: "dwa-page-title",
-								children: acp.label("NTR 设置", "NTR settings")
+								"aria-label": acp.label("NTR 设置", "NTR settings"),
+								children: [
+									acp.label("NTR 设置", "NTR settings"),
+									ui.pluginVersion !== void 0 && (versionOpensUpdate ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dwa-badge dwa-version dwa-version-btn",
+										title: versionTitle,
+										"aria-expanded": updateOpen,
+										"aria-controls": "ntr-plugin-update-card",
+										onClick: () => setUpdateOpen((open) => !open),
+										children: `v${ui.pluginVersion}`
+									}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dwa-badge dwa-version",
+										title: versionTitle,
+										children: `v${ui.pluginVersion}`
+									})),
+									update !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PluginUpdateBadge, {
+										acp,
+										update,
+										open: updateOpen,
+										onToggle: () => setUpdateOpen((open) => !open)
+									})
+								]
 							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 								className: "dwa-page-description",
 								children: acp.label("连接智能体，设置你的对话偏好。", "Connect agents and set your conversation preferences.")
@@ -3356,6 +3718,11 @@ window.__ModuleLoader__.load({
 							children: acp.label("添加智能体", "Add agent")
 						})]
 					}),
+					update !== void 0 && updateCardVisible(update, updateOpen) && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PluginUpdateCard, {
+						acp,
+						update,
+						onClose: () => setUpdateOpen(false)
+					}),
 					ledger.visible && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "dwa-card dwa-card-warn",
 						style: { marginBottom: 16 },
@@ -3464,6 +3831,15 @@ window.__ModuleLoader__.load({
 								"aria-pressed": page === "appearance",
 								onClick: () => setPage("appearance"),
 								children: acp.label("对话外观", "Appearance")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+								type: "button",
+								"aria-pressed": page === "logs",
+								onClick: () => setPage("logs"),
+								children: [acp.label("日志", "Logs"), ui.logUnread > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dwa-log-dot",
+									"aria-hidden": "true"
+								})]
 							})
 						]
 					}),
@@ -3715,6 +4091,52 @@ window.__ModuleLoader__.load({
 							})]
 						})]
 					}),
+					page === "logs" && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+						className: "dwa-section",
+						"aria-label": acp.label("运行日志", "Runtime log"),
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dwa-section-heading",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+								className: "dwa-section-title",
+								children: acp.label("运行日志", "Runtime log")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "dwa-section-copy",
+								children: acp.label(`agent 运行消息，最多 ${String(200)} 条。`, `Agent runtime messages, up to ${String(200)}.`)
+							})] }), ui.logs.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dwa-btn dwa-btn-quiet",
+								onClick: () => acp.clearLogs(),
+								children: acp.label("清空", "Clear")
+							})]
+						}), ui.logs.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dwa-empty",
+							role: "status",
+							children: acp.label("暂无运行日志。", "No runtime messages yet.")
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+							className: "dwa-log-list",
+							children: [...ui.logs].reverse().map((entry) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
+								className: entry.level === "error" ? "dwa-log-row is-error" : "dwa-log-row",
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dwa-log-time dwa-mono",
+										children: logClock(entry.at)
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: `dwa-badge dwa-log-level ${entry.level === "error" ? "is-error" : "is-info"}`,
+										children: entry.level === "error" ? acp.label("错误", "Error") : acp.label("信息", "Info")
+									}),
+									entry.agentId !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dwa-badge",
+										children: entry.agentId
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dwa-log-text",
+										children: entry.text
+									})
+								]
+							}, entry.id))
+						})]
+					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("footer", {
 						className: "dwa-health",
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {