dsh-ntr 0.2.1 → 0.3.1

package/lib/client/panel.js

@@ -17,7 +17,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  */
 import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
 import { formatCommandLine, isAbsolutePathLike, splitCommandLine } from "./acp-ui.js";
-import { DEFAULT_KNOWN_PRESETS } from "./store.js";
+import { DEFAULT_KNOWN_PRESETS, LOG_MAX_ENTRIES } from "./store.js";
 /**
  * Mirrors `AGENT_ID_PATTERN` in impl.ts — the client cannot import host-side
  * modules, so this copy must stay in sync (same deal as the preset copies,
@@ -74,7 +74,7 @@ const STYLE = `
 }
 .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);
@@ -106,6 +106,20 @@ const STYLE = `
 .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; }
@@ -228,6 +242,17 @@ const STYLE = `
 .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; }
 }
@@ -712,6 +737,112 @@ function ApprovalDeadlinesCard(props) {
     const waitMode = deadlines.mode === 'wait';
     return (_jsxs("section", { className: "dwa-section", children: [_jsx("div", { className: "dwa-section-heading", children: _jsxs("div", { children: [_jsx("h3", { className: "dwa-section-title", children: acp.label('审批时限', 'Approval deadlines') }), _jsx("p", { className: "dwa-section-copy", children: acp.label('权限请求的等待时长与超时处理方式。', 'How long to wait for a permission request, and what happens when nobody answers.') })] }) }), _jsxs("div", { className: "dwa-preferences", children: [_jsx(DeadlineModeBlock, { acp: acp, mode: deadlines.mode, override: modeNote }), _jsx(DeadlineSliderBlock, { acp: acp, value: waitMode ? undefined : deadlines.permissionTimeoutMs, mode: deadlines.mode, override: baselineNote }), facts.overridden && (_jsx("div", { className: "dwa-deadline-reset", children: _jsx("button", { type: "button", className: "dwa-btn dwa-btn-secondary", onClick: () => void acp.resetApprovalDeadlines(), children: acp.label('恢复配置文件的值', 'Use config file value') }) }))] })] }));
 }
+/**
+ * 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') {
+        // Only a KNOWN disk version can be named. An interrupted install leaves
+        // `installed` unset, and a badge would have to invent a version.
+        if (update.installed === undefined)
+            return undefined;
+        // Neutral: the disk version can be newer OR older than the running one.
+        return acp.label(`待重启 v${update.installed}`, `Restart for v${update.installed}`);
+    }
+    return undefined;
+}
+/**
+ * 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 === undefined)
+        return null;
+    return (_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 !== undefined && update.installed !== update.current
+        ? update.installed
+        : undefined;
+    const published = update.publishedAt !== undefined && !Number.isNaN(new Date(update.publishedAt).getTime())
+        ? new Date(update.publishedAt).toLocaleDateString()
+        : undefined;
+    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 !== undefined
+                    ? 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.')
+                                    : undefined;
+    const showMessage = (update.status === 'failed' || update.status === 'busy' || update.status === 'managed')
+        && update.message !== undefined;
+    const apply = async () => {
+        if (update.latest === undefined)
+            return;
+        try {
+            await acp.applyPluginUpdate(update.latest);
+        }
+        catch {
+            // The store keeps the "disk may have changed" state and writes its own notice.
+        }
+    };
+    return (_jsxs("div", { id: "ntr-plugin-update-card", className: "dwa-card dwa-update-card", role: "group", "aria-label": acp.label('插件更新', 'Plugin update'), children: [_jsxs("div", { className: "dwa-update-summary", children: [_jsx("span", { children: acp.label(`当前 v${update.current}`, `Current v${update.current}`) }), onDisk !== undefined && _jsx("span", { className: "dwa-hint", children: acp.label(`磁盘 v${onDisk}`, `On disk v${onDisk}`) }), update.latest !== undefined && (_jsxs(_Fragment, { children: [_jsx("span", { "aria-hidden": "true", children: "\u2192" }), _jsx("span", { children: acp.label(`最新 v${latest}`, `Latest v${latest}`) }), published !== undefined && _jsx("span", { className: "dwa-hint", children: published })] }))] }), copy !== undefined && _jsx("p", { className: "dwa-update-copy", children: copy }), showMessage && _jsx("div", { className: "dwa-update-message", children: update.message }), _jsxs("div", { className: "dwa-row-actions dwa-update-actions", children: [update.status === 'available' && (_jsx("button", { type: "button", className: "dwa-btn dwa-btn-primary", onClick: () => { void apply(); }, children: acp.label('更新', 'Update') })), applying && (_jsx("button", { type: "button", className: "dwa-btn dwa-btn-primary", disabled: true, children: acp.label('正在更新…', 'Updating…') })), update.status !== 'applying' && (_jsx("button", { type: "button", className: "dwa-btn", onClick: onClose, children: acp.label('关闭', 'Close') })), _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 === undefined || !open)
+        return false;
+    return update.status !== 'unsupported' && update.status !== 'not-installed';
+}
 export function AcpSettingsSection(props) {
     const acp = props.acp;
     ensureStyle();
@@ -720,6 +851,18 @@ export function AcpSettingsSection(props) {
     const [page, setPage] = useState('agents');
     const [addOpen, setAddOpen] = useState(false);
     const [addTarget, setAddTarget] = useState(undefined);
+    const [updateOpen, setUpdateOpen] = useState(false);
+    // The store throttles this to one registry read per ten minutes, so every
+    // remount (both settings entries mount this section) is cheap.
+    useEffect(() => {
+        void acp.checkPluginUpdate();
+    }, [acp]);
+    // Opening the log is the read receipt. The store does not mutate at zero,
+    // so this cannot loop.
+    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 = () => {
@@ -727,7 +870,20 @@ export function AcpSettingsSection(props) {
         setPage('add');
     };
     const presetProblem = ui.preset !== undefined && (!ui.preset.installed || ui.preset.problem !== undefined);
-    return (_jsxs("div", { className: "dwa-root", children: [_jsxs("header", { className: "dwa-page-header", children: [_jsxs("div", { className: "dwa-page-heading", children: [_jsx("h2", { className: "dwa-page-title", children: acp.label('NTR 设置', 'NTR settings') }), _jsx("p", { className: "dwa-page-description", children: acp.label('连接智能体，设置你的对话偏好。', 'Connect agents and set your conversation preferences.') })] }), page === 'agents' && configured.length > 0 && (_jsx("button", { type: "button", className: "dwa-btn dwa-btn-primary", onClick: openAdd, children: acp.label('添加智能体', 'Add agent') }))] }), ledger.visible && (_jsxs("div", { className: "dwa-card dwa-card-warn", style: { marginBottom: 16 }, children: [_jsx("div", { style: { fontWeight: 600, marginBottom: 4 }, children: acp.label('待处理权限请求', 'Pending Permission Requests') }), _jsx("div", { className: "dwa-hint", style: { marginBottom: 8 }, children: acp.label('对话打开时在那边的卡片上回答；这里兜底显示其他会话的询问。', 'Answer in the conversation card while that conversation is open; this list covers the asks whose conversation is not.') }), ui.permissions.map(permission => (_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 8, marginBottom: 6, flexWrap: 'wrap' }, children: [_jsxs("span", { style: { flex: 1, minWidth: 160 }, children: [_jsx("span", { style: { fontWeight: 600 }, children: permission.toolName }), permission.reason !== undefined && (_jsxs("span", { style: { color: 'var(--ntr-muted)' }, children: [" \u00B7 ", permission.reason] }))] }), permission.options.map(option => (_jsx("button", { type: "button", className: "dwa-btn", onClick: () => { void acp.respondPermission(permission.requestId, option.optionId).catch(() => undefined); }, children: option.name }, option.optionId))), _jsx("button", { type: "button", className: "dwa-btn dwa-btn-quiet", onClick: () => { void acp.respondPermission(permission.requestId).catch(() => undefined); }, children: acp.label('取消', 'Cancel') })] }, permission.requestId)))] })), ui.notice !== undefined && (_jsxs("div", { className: "dwa-card dwa-card-warn", style: { marginBottom: 16, display: 'flex', alignItems: 'center', gap: 8 }, children: [_jsx("span", { style: { flex: 1 }, children: ui.notice }), _jsx("button", { type: "button", className: "dwa-btn dwa-btn-quiet", "aria-label": acp.label('关闭通知', 'Dismiss notice'), onClick: () => acp.clearNotice(), children: "\u2715" })] })), presetProblem && (_jsxs("div", { className: "dwa-card dwa-card-warn dwa-notice", role: "status", children: [_jsx("span", { children: acp.label('NTR 模式需要检查，当前可能无法开始对话。', 'NTR mode needs attention; new conversations may be unavailable.') }), _jsx("button", { type: "button", className: "dwa-btn", onClick: () => setPage('diagnostics'), children: acp.label('查看诊断', 'View diagnostics') })] })), _jsxs("nav", { className: "dwa-tabs", "aria-label": acp.label('NTR 设置分类', 'NTR settings categories'), children: [_jsx("button", { type: "button", "aria-pressed": page === 'agents', onClick: () => setPage('agents'), children: acp.label('智能体', 'Agents') }), ui.approvalDeadlines !== undefined && _jsx("button", { type: "button", "aria-pressed": page === 'approvals', onClick: () => setPage('approvals'), children: acp.label('审批时限', 'Approval deadlines') }), _jsx("button", { type: "button", "aria-pressed": page === 'appearance', onClick: () => setPage('appearance'), children: acp.label('对话外观', 'Appearance') })] }), page === 'diagnostics' && (_jsxs("section", { className: "dwa-section", children: [_jsx("h3", { className: "dwa-section-title", children: acp.label('连接诊断', 'Connection diagnostics') }), _jsxs("div", { className: "dwa-preference-row", children: [_jsx("span", { children: acp.label('宿主事件流', 'Host event stream') }), _jsx("span", { className: "dwa-hint", children: streamText(ui.stream, acp) })] }), _jsxs("div", { className: "dwa-row-actions", children: [_jsx("button", { type: "button", className: "dwa-btn", onClick: () => { void acp.resync(); void acp.detectAgents(); }, disabled: ui.detecting, children: ui.detecting ? acp.label('检测中...', 'Detecting...') : acp.label('重新检测与刷新', 'Re-detect & Refresh') }), ui.detectSummary !== undefined && _jsx("span", { className: "dwa-hint", role: "status", children: ui.detectSummary })] })] })), page === 'diagnostics' && ui.preset !== undefined && (_jsxs("div", { className: "dwa-card dwa-mode-banner", children: [_jsxs("div", { className: "dwa-mode-title", children: [acp.label('NTR 模式', 'NTR mode'), _jsx("span", { className: "dwa-badge", children: ui.preset.id })] }), _jsx("span", { className: `dwa-badge ${ui.preset.installed ? 'dwa-badge-success' : 'dwa-badge-warn'}`, children: ui.preset.installed ? acp.label('已就绪', 'Ready') : acp.label('需检查', 'Needs attention') }), _jsxs("div", { className: "dwa-mode-copy", children: [ui.preset.installed
+    const update = ui.pluginUpdate;
+    // A source install cannot be replaced by this browser; the version badge
+    // says so on hover. Neutral wording: a checkout may be git or not.
+    const versionTitle = update?.status === 'source-install'
+        ? acp.label('源码或本地安装，无法通过 registry 更新。', 'Source or local install; update it through its own checkout.')
+        : undefined;
+    // The running version is the update entry: every state with a real install
+    // report can open the card, including "up to date" (which offers a re-check).
+    const versionOpensUpdate = update !== undefined
+        && update.status !== 'unsupported'
+        && update.status !== 'not-installed';
+    return (_jsxs("div", { className: "dwa-root", children: [_jsxs("header", { className: "dwa-page-header", children: [_jsxs("div", { className: "dwa-page-heading", children: [_jsxs("h2", { className: "dwa-page-title", "aria-label": acp.label('NTR 设置', 'NTR settings'), children: [acp.label('NTR 设置', 'NTR settings'), ui.pluginVersion !== undefined && (versionOpensUpdate
+                                        ? (_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}` }))
+                                        : _jsx("span", { className: "dwa-badge dwa-version", title: versionTitle, children: `v${ui.pluginVersion}` })), update !== undefined && (_jsx(PluginUpdateBadge, { acp: acp, update: update, open: updateOpen, onToggle: () => setUpdateOpen(open => !open) }))] }), _jsx("p", { className: "dwa-page-description", children: acp.label('连接智能体，设置你的对话偏好。', 'Connect agents and set your conversation preferences.') })] }), page === 'agents' && configured.length > 0 && (_jsx("button", { type: "button", className: "dwa-btn dwa-btn-primary", onClick: openAdd, children: acp.label('添加智能体', 'Add agent') }))] }), update !== undefined && updateCardVisible(update, updateOpen) && (_jsx(PluginUpdateCard, { acp: acp, update: update, onClose: () => setUpdateOpen(false) })), ledger.visible && (_jsxs("div", { className: "dwa-card dwa-card-warn", style: { marginBottom: 16 }, children: [_jsx("div", { style: { fontWeight: 600, marginBottom: 4 }, children: acp.label('待处理权限请求', 'Pending Permission Requests') }), _jsx("div", { className: "dwa-hint", style: { marginBottom: 8 }, children: acp.label('对话打开时在那边的卡片上回答；这里兜底显示其他会话的询问。', 'Answer in the conversation card while that conversation is open; this list covers the asks whose conversation is not.') }), ui.permissions.map(permission => (_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 8, marginBottom: 6, flexWrap: 'wrap' }, children: [_jsxs("span", { style: { flex: 1, minWidth: 160 }, children: [_jsx("span", { style: { fontWeight: 600 }, children: permission.toolName }), permission.reason !== undefined && (_jsxs("span", { style: { color: 'var(--ntr-muted)' }, children: [" \u00B7 ", permission.reason] }))] }), permission.options.map(option => (_jsx("button", { type: "button", className: "dwa-btn", onClick: () => { void acp.respondPermission(permission.requestId, option.optionId).catch(() => undefined); }, children: option.name }, option.optionId))), _jsx("button", { type: "button", className: "dwa-btn dwa-btn-quiet", onClick: () => { void acp.respondPermission(permission.requestId).catch(() => undefined); }, children: acp.label('取消', 'Cancel') })] }, permission.requestId)))] })), ui.notice !== undefined && (_jsxs("div", { className: "dwa-card dwa-card-warn", style: { marginBottom: 16, display: 'flex', alignItems: 'center', gap: 8 }, children: [_jsx("span", { style: { flex: 1 }, children: ui.notice }), _jsx("button", { type: "button", className: "dwa-btn dwa-btn-quiet", "aria-label": acp.label('关闭通知', 'Dismiss notice'), onClick: () => acp.clearNotice(), children: "\u2715" })] })), presetProblem && (_jsxs("div", { className: "dwa-card dwa-card-warn dwa-notice", role: "status", children: [_jsx("span", { children: acp.label('NTR 模式需要检查，当前可能无法开始对话。', 'NTR mode needs attention; new conversations may be unavailable.') }), _jsx("button", { type: "button", className: "dwa-btn", onClick: () => setPage('diagnostics'), children: acp.label('查看诊断', 'View diagnostics') })] })), _jsxs("nav", { className: "dwa-tabs", "aria-label": acp.label('NTR 设置分类', 'NTR settings categories'), children: [_jsx("button", { type: "button", "aria-pressed": page === 'agents', onClick: () => setPage('agents'), children: acp.label('智能体', 'Agents') }), ui.approvalDeadlines !== undefined && _jsx("button", { type: "button", "aria-pressed": page === 'approvals', onClick: () => setPage('approvals'), children: acp.label('审批时限', 'Approval deadlines') }), _jsx("button", { type: "button", "aria-pressed": page === 'appearance', onClick: () => setPage('appearance'), children: acp.label('对话外观', 'Appearance') }), _jsxs("button", { type: "button", "aria-pressed": page === 'logs', onClick: () => setPage('logs'), children: [acp.label('日志', 'Logs'), ui.logUnread > 0 && _jsx("span", { className: "dwa-log-dot", "aria-hidden": "true" })] })] }), page === 'diagnostics' && (_jsxs("section", { className: "dwa-section", children: [_jsx("h3", { className: "dwa-section-title", children: acp.label('连接诊断', 'Connection diagnostics') }), _jsxs("div", { className: "dwa-preference-row", children: [_jsx("span", { children: acp.label('宿主事件流', 'Host event stream') }), _jsx("span", { className: "dwa-hint", children: streamText(ui.stream, acp) })] }), _jsxs("div", { className: "dwa-row-actions", children: [_jsx("button", { type: "button", className: "dwa-btn", onClick: () => { void acp.resync(); void acp.detectAgents(); }, disabled: ui.detecting, children: ui.detecting ? acp.label('检测中...', 'Detecting...') : acp.label('重新检测与刷新', 'Re-detect & Refresh') }), ui.detectSummary !== undefined && _jsx("span", { className: "dwa-hint", role: "status", children: ui.detectSummary })] })] })), page === 'diagnostics' && ui.preset !== undefined && (_jsxs("div", { className: "dwa-card dwa-mode-banner", children: [_jsxs("div", { className: "dwa-mode-title", children: [acp.label('NTR 模式', 'NTR mode'), _jsx("span", { className: "dwa-badge", children: ui.preset.id })] }), _jsx("span", { className: `dwa-badge ${ui.preset.installed ? 'dwa-badge-success' : 'dwa-badge-warn'}`, children: ui.preset.installed ? acp.label('已就绪', 'Ready') : acp.label('需检查', 'Needs attention') }), _jsxs("div", { className: "dwa-mode-copy", children: [ui.preset.installed
                                 ? acp.label('已加入宿主模式列表，新建会话时选择「NTR 模式」即可使用。', 'Added to the harness roster. Pick “NTR mode” when creating a session.')
                                 : acp.label('宿主模式列表中没有可用的「NTR 模式」，请检查预设声明。', 'The harness roster has no usable “NTR mode”. Check the preset declaration.'), _jsx("code", { className: "dwa-mode-source dwa-mono", children: ui.preset.source })] }), ui.preset.problem !== undefined && (_jsx("div", { className: "dwa-hint", style: { gridColumn: '1 / -1', color: 'var(--ntr-warn)' }, children: acp.label(`宿主报告：${ui.preset.problem}`, `Harness reported: ${ui.preset.problem}`) }))] })), _jsxs("section", { className: "dwa-section", hidden: page !== 'agents', "aria-label": acp.label('已接入的智能体', 'Connected agents'), children: [_jsxs("div", { className: "dwa-section-heading", children: [_jsx("div", { children: _jsxs("h3", { className: "dwa-section-title", children: [acp.label('已接入的智能体', 'Connected agents'), ui.agentsLoaded && _jsx("span", { className: "dwa-badge", children: configured.length })] }) }), configured.length > 0 && _jsx("span", { className: "dwa-hint", children: acp.label('默认项用于新的 NTR 会话', 'The default serves new NTR conversations') })] }), !ui.agentsLoaded && _jsx("div", { className: "dwa-empty", role: "status", children: acp.label('正在读取智能体…', 'Loading agents…') }), ui.agentsLoaded && configured.length === 0 && (_jsxs("div", { className: "dwa-empty", children: [_jsx("h3", { children: acp.label('接入第一个智能体', 'Connect your first agent') }), _jsx("p", { className: "dwa-section-copy", children: acp.label('选择已有预设，或填写自己的 ACP 启动命令。', 'Choose a preset or enter your own ACP launch command.') }), _jsx("button", { type: "button", className: "dwa-btn dwa-btn-primary", onClick: openAdd, children: acp.label('添加智能体', 'Add agent') })] })), _jsx("div", { className: "dwa-agent-list", children: configured.map(({ info, synthesized }) => {
                             const activeAgent = ui.agents.find(a => a.id === info.id);
@@ -736,7 +892,9 @@ export function AcpSettingsSection(props) {
                                             setAddTarget(undefined);
                                             setAddOpen(false);
                                             setPage('agents');
-                                        } }, selected.id)] }))] })] }), _jsx("div", { hidden: page !== 'approvals', children: _jsx(ApprovalDeadlinesCard, { acp: acp, ui: ui }) }), _jsxs("section", { className: "dwa-section", hidden: page !== 'appearance', "aria-label": acp.label('对话外观', 'Appearance'), children: [_jsx("div", { className: "dwa-section-heading", children: _jsxs("div", { children: [_jsx("h3", { className: "dwa-section-title", children: acp.label('对话外观', 'Conversation appearance') }), _jsx("p", { className: "dwa-section-copy", children: acp.label('设置对话中 NTR 挂牌的进程存活提示。', 'Choose how the NTR tag indicates a running agent process.') })] }) }), _jsxs("div", { className: "dwa-preferences", children: [_jsxs("div", { className: "dwa-preference-row", children: [_jsxs("div", { children: [_jsx("div", { className: "dwa-preference-label", children: acp.label('挂牌光晕', 'Tag halo') }), _jsx("div", { className: "dwa-preference-copy", children: acp.label('呼吸为脉动光，常亮为恒定光。', 'Breathe pulses gently; steady keeps a constant glow.') })] }), _jsx("div", { className: "dwa-seg", children: ['breath', 'steady'].map(mode => (_jsx("button", { type: "button", className: ui.tagHalo.mode === mode ? 'is-on' : '', onClick: () => void acp.setTagHalo({ ...ui.tagHalo, mode }), children: mode === 'breath' ? acp.label('呼吸', 'Breathe') : acp.label('常亮', 'Steady') }, mode))) })] }), ui.tagHalo.mode === 'breath' && (_jsxs("div", { className: "dwa-preference-row", children: [_jsxs("div", { children: [_jsx("div", { className: "dwa-preference-label", children: acp.label('呼吸频率', 'Breathing speed') }), _jsx("div", { className: "dwa-preference-copy", children: acp.label('控制光晕的脉动速度。', 'Controls how quickly the halo pulses.') })] }), _jsx("div", { className: "dwa-seg", children: ['slow', 'normal', 'fast'].map(speed => (_jsx("button", { type: "button", className: ui.tagHalo.speed === speed ? 'is-on' : '', onClick: () => void acp.setTagHalo({ ...ui.tagHalo, speed }), children: speed === 'slow' ? acp.label('慢速', 'Slow') : speed === 'normal' ? acp.label('正常', 'Normal') : acp.label('快速', 'Fast') }, speed))) })] }))] })] }), _jsxs("footer", { className: "dwa-health", children: [_jsxs("div", { className: "dwa-health-status", children: [_jsx("span", { className: "dwa-dot", style: { background: ui.stream === 'live' ? 'var(--ntr-success)' : ui.stream === 'down' ? 'var(--ntr-danger)' : 'var(--ntr-muted)' } }), _jsx("span", { children: streamText(ui.stream, acp) }), ui.preset !== undefined && _jsx("span", { children: ui.preset.installed && !presetProblem ? acp.label('NTR 模式已就绪', 'NTR mode ready') : acp.label('NTR 模式需检查', 'NTR mode needs attention') })] }), page !== 'diagnostics' && _jsx("button", { type: "button", className: "dwa-btn dwa-btn-quiet", onClick: () => setPage('diagnostics'), children: acp.label('查看诊断', 'View diagnostics') })] })] }));
+                                        } }, selected.id)] }))] })] }), _jsx("div", { hidden: page !== 'approvals', children: _jsx(ApprovalDeadlinesCard, { acp: acp, ui: ui }) }), _jsxs("section", { className: "dwa-section", hidden: page !== 'appearance', "aria-label": acp.label('对话外观', 'Appearance'), children: [_jsx("div", { className: "dwa-section-heading", children: _jsxs("div", { children: [_jsx("h3", { className: "dwa-section-title", children: acp.label('对话外观', 'Conversation appearance') }), _jsx("p", { className: "dwa-section-copy", children: acp.label('设置对话中 NTR 挂牌的进程存活提示。', 'Choose how the NTR tag indicates a running agent process.') })] }) }), _jsxs("div", { className: "dwa-preferences", children: [_jsxs("div", { className: "dwa-preference-row", children: [_jsxs("div", { children: [_jsx("div", { className: "dwa-preference-label", children: acp.label('挂牌光晕', 'Tag halo') }), _jsx("div", { className: "dwa-preference-copy", children: acp.label('呼吸为脉动光，常亮为恒定光。', 'Breathe pulses gently; steady keeps a constant glow.') })] }), _jsx("div", { className: "dwa-seg", children: ['breath', 'steady'].map(mode => (_jsx("button", { type: "button", className: ui.tagHalo.mode === mode ? 'is-on' : '', onClick: () => void acp.setTagHalo({ ...ui.tagHalo, mode }), children: mode === 'breath' ? acp.label('呼吸', 'Breathe') : acp.label('常亮', 'Steady') }, mode))) })] }), ui.tagHalo.mode === 'breath' && (_jsxs("div", { className: "dwa-preference-row", children: [_jsxs("div", { children: [_jsx("div", { className: "dwa-preference-label", children: acp.label('呼吸频率', 'Breathing speed') }), _jsx("div", { className: "dwa-preference-copy", children: acp.label('控制光晕的脉动速度。', 'Controls how quickly the halo pulses.') })] }), _jsx("div", { className: "dwa-seg", children: ['slow', 'normal', 'fast'].map(speed => (_jsx("button", { type: "button", className: ui.tagHalo.speed === speed ? 'is-on' : '', onClick: () => void acp.setTagHalo({ ...ui.tagHalo, speed }), children: speed === 'slow' ? acp.label('慢速', 'Slow') : speed === 'normal' ? acp.label('正常', 'Normal') : acp.label('快速', 'Fast') }, speed))) })] }))] })] }), page === 'logs' && (_jsxs("section", { className: "dwa-section", "aria-label": acp.label('运行日志', 'Runtime log'), children: [_jsxs("div", { className: "dwa-section-heading", children: [_jsxs("div", { children: [_jsx("h3", { className: "dwa-section-title", children: acp.label('运行日志', 'Runtime log') }), _jsx("p", { className: "dwa-section-copy", children: acp.label(`agent 运行消息，最多 ${String(LOG_MAX_ENTRIES)} 条。`, `Agent runtime messages, up to ${String(LOG_MAX_ENTRIES)}.`) })] }), ui.logs.length > 0 && (_jsx("button", { type: "button", className: "dwa-btn dwa-btn-quiet", onClick: () => acp.clearLogs(), children: acp.label('清空', 'Clear') }))] }), ui.logs.length === 0
+                        ? _jsx("div", { className: "dwa-empty", role: "status", children: acp.label('暂无运行日志。', 'No runtime messages yet.') })
+                        : (_jsx("ul", { className: "dwa-log-list", children: [...ui.logs].reverse().map(entry => (_jsxs("li", { className: entry.level === 'error' ? 'dwa-log-row is-error' : 'dwa-log-row', children: [_jsx("span", { className: "dwa-log-time dwa-mono", children: logClock(entry.at) }), _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 !== undefined && _jsx("span", { className: "dwa-badge", children: entry.agentId }), _jsx("span", { className: "dwa-log-text", children: entry.text })] }, entry.id))) }))] })), _jsxs("footer", { className: "dwa-health", children: [_jsxs("div", { className: "dwa-health-status", children: [_jsx("span", { className: "dwa-dot", style: { background: ui.stream === 'live' ? 'var(--ntr-success)' : ui.stream === 'down' ? 'var(--ntr-danger)' : 'var(--ntr-muted)' } }), _jsx("span", { children: streamText(ui.stream, acp) }), ui.preset !== undefined && _jsx("span", { children: ui.preset.installed && !presetProblem ? acp.label('NTR 模式已就绪', 'NTR mode ready') : acp.label('NTR 模式需检查', 'NTR mode needs attention') })] }), page !== 'diagnostics' && _jsx("button", { type: "button", className: "dwa-btn dwa-btn-quiet", onClick: () => setPage('diagnostics'), children: acp.label('查看诊断', 'View diagnostics') })] })] }));
 }
 /** One row per agent: compact when collapsed, the full form when expanded. */
 function AgentRow({ detected, activeAgent, acp, isDefault, synthesized, active, newCustom = false, onCreated, }) {

package/lib/client/store.js

@@ -39,11 +39,19 @@ export function deadlineRemainingLabel(deadlineAt, now, mode) {
     const rest = seconds % 60;
     return rest === 0 ? `${String(minutes)}m` : `${String(minutes)}m ${String(rest)}s`;
 }
+/** Cap on retained runtime-log lines; older entries fall off the front. */
+export const LOG_MAX_ENTRIES = 200;
 const MAX_BLOCKS = 400;
 /** How many observed ACP transcripts stay live at once (insertion-ordered eviction). */
 const MAX_WATCHED = 6;
 /** Raw JSON budget for one event block; the cut is marked. */
 const RAW_MAX = 256_000;
+/**
+ * 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 = 10 * 60 * 1000;
 /** Pretty-printed JSON of an agent message (never throws, cuts only at {@link RAW_MAX} with a marker). */
 export function jsonText(value) {
     let text;
@@ -279,6 +287,14 @@ export const DEFAULT_KNOWN_PRESETS = [
         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',
@@ -325,6 +341,8 @@ export class AcpStore {
         blocks: [],
         permissions: [],
         busy: false,
+        logs: [],
+        logUnread: 0,
         detectedAgents: [...DEFAULT_KNOWN_PRESETS],
         detecting: false,
         modelCatalogs: {},
@@ -346,6 +364,8 @@ export class AcpStore {
     };
     listeners = new Set();
     source;
+    /** Monotonic id source for {@link AcpLogEntry}s (never reset by `clearLogs`). */
+    logSeq = 0;
     lastSeq = new Map();
     /** Sessions with a finalized turn (dedups the cancel-fallback + late real turn/end pair). */
     openTurns = new Set();
@@ -394,6 +414,22 @@ export class AcpStore {
     cachedModelReads = 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;
@@ -415,6 +451,23 @@ export class AcpStore {
         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 === undefined ? {} : { agentId }),
+        };
+        return {
+            logs: [...this.state.logs, entry].slice(-LOG_MAX_ENTRIES),
+            logUnread: this.state.logUnread + 1,
+        };
+    }
     // ---- Streaming update coalescing ----
     /**
      * Live `session/update` frames waiting to be folded. Agents stream at token
@@ -533,7 +586,7 @@ export class AcpStore {
     /** 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'),
                 // The plugin's OWN default ACP agent — a plugin-private id, not a DSH
@@ -547,6 +600,9 @@ export class AcpStore {
                 // `undefined` (older half) hides the deadline card instead of showing a
                 // number this browser made up.
                 this.call('ui/approval-deadlines').catch(() => ({ deadlines: undefined })),
+                // The settings badge's data source; older halves answer `unknown
+                // endpoint`, which hides the badge.
+                this.call('plugin/version').catch(() => null),
             ]);
             const detectedAgents = (detectResult && detectResult.agents.length > 0)
                 ? detectResult.agents
@@ -561,6 +617,7 @@ export class AcpStore {
                 preset: presetResult?.preset ?? undefined,
                 tagHalo: tagHaloResult?.halo ?? { ...DEFAULT_TAG_HALO },
                 approvalDeadlines: deadlinesResult.deadlines,
+                pluginVersion: versionResult?.version !== undefined && versionResult.version !== '' ? versionResult.version : undefined,
             });
             const active = this.state.activeSessionId ?? sessions[0]?.sessionId;
             if (active !== undefined)
@@ -570,6 +627,104 @@ export class AcpStore {
             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) {
+        // One read for every caller while it is in flight, force included: the
+        // settings page and the popover mounting together must not hit the
+        // registry twice.
+        if (this.pluginUpdateInflight !== undefined)
+            return this.pluginUpdateInflight;
+        const current = this.state.pluginUpdate;
+        if (!force && current !== undefined && 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 = undefined;
+        }
+    }
+    async readPluginUpdate(generation) {
+        try {
+            const pluginUpdate = await this.call('plugin/update-check');
+            // An install started while this read was in flight: its answer is
+            // already stale, and the install's verdict owns the state now.
+            if (generation !== this.pluginUpdateGeneration)
+                return undefined;
+            this.pluginUpdateFetchedAt = Date.now();
+            this.mutate({ pluginUpdate });
+            return pluginUpdate;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * 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 undefined;
+        this.pluginUpdateApplying = true;
+        // Any check already in flight predates the install; its answer must not
+        // land on top of the install's verdict.
+        this.pluginUpdateGeneration += 1;
+        const previous = this.state.pluginUpdate;
+        if (previous !== undefined) {
+            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);
+            // The disk state is UNKNOWN here: the install may have completed before
+            // the response was cut. Keep `latest` for display, drop `installed` so no
+            // surface can claim a disk version we never read, and reset the throttle
+            // so the next check actually asks the host instead of serving this
+            // unknown verdict for ten minutes.
+            const interrupted = previous !== undefined
+                ? { ...previous, status: 'restart-required', installed: undefined, 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 undefined;
+        }
+        finally {
+            // Invalidate reads that STARTED during the install: their "applying"
+            // answer would otherwise land on top of this call's final verdict.
+            this.pluginUpdateGeneration += 1;
+            this.pluginUpdateApplying = false;
+        }
+    }
     async detectAgents() {
         this.mutate({ detecting: true });
         try {
@@ -1496,6 +1651,16 @@ export class AcpStore {
     clearNotice() {
         this.mutate({ notice: undefined });
     }
+    /** 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) });
     }
@@ -1503,7 +1668,7 @@ export class AcpStore {
     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': {
@@ -1534,6 +1699,7 @@ export class AcpStore {
                 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);
@@ -1549,7 +1715,9 @@ export class AcpStore {
                     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();
             }
@@ -1566,6 +1734,22 @@ export class AcpStore {
                 const chatSessions = this.state.chatSessions.some(s => s.sessionId === event.sessionId)
                     ? this.state.chatSessions.map(s => (s.sessionId === event.sessionId ? { ...s, released: true } : s))
                     : this.state.chatSessions;
+                // One runtime-log line per release cause; `idle` stays silent on
+                // purpose (an expected lifecycle transition, not a fault).
+                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 } : {}),
@@ -1573,7 +1757,7 @@ export class AcpStore {
                     // An observed transcript keeps its buffer but flips to released, so
                     // the ACP view can say "会恢复" instead of silently looking dead.
                     ...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();
             }