dsh-ntr 0.2.1 → 0.3.0

package/lib/client/panel.js

@@ -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; }
@@ -712,6 +726,101 @@ 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') }) }))] })] }));
 }
+/** 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 +829,12 @@ 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]);
     const { configured, available } = partitionAgents(ui.detectedAgents, ui.agents);
     const selected = addTarget ?? available[0] ?? NEW_AGENT_SEED;
     const openAdd = () => {
@@ -727,7 +842,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') })] }), 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);

package/lib/client/store.js

@@ -44,6 +44,12 @@ const MAX_BLOCKS = 400;
 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 +285,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',
@@ -394,6 +408,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;
@@ -533,7 +563,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 +577,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 +594,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 +604,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 {