dsh-ntr 0.3.0 → 0.3.1

package/lib/bridge.js

@@ -329,7 +329,7 @@ export class AgentBridge {
             this.touch();
             return;
         }
-        this.releaseAll(`agent "${this.def.id}" was released after ${String(Math.round(this.currentIdleTimeoutMs / 1000))}s idle`);
+        this.releaseAll(`agent "${this.def.id}" was released after ${String(Math.round(this.currentIdleTimeoutMs / 1000))}s idle`, 'idle');
     }
     /**
      * Claim this bridge's single prompt slot for one turn, waiting (bounded) for
@@ -532,7 +532,7 @@ export class AgentBridge {
             if (this.state === 'ready' && this.conn !== undefined && this.spawnCwd !== spawnCwd && this.isQuiet()) {
                 const reason = `agent "${this.def.id}" restarts in ${spawnCwd} (the workspace of the session using it)`;
                 this.hub.broadcast({ type: 'agent/notice', agentId: this.def.id, level: 'info', text: `acp: ${reason}` });
-                this.releaseAll(reason);
+                this.releaseAll(reason, 'workspace');
             }
         }
         if (this.state === 'ready' && this.conn !== undefined)
@@ -979,12 +979,12 @@ export class AgentBridge {
             this.sessions.delete(session.sessionId);
             session.released = true;
             this.released.set(session.sessionId, session);
-            this.hub.broadcast({ type: 'session/released', sessionId: session.sessionId, session: snapshot(session), reason: 'resume failed' });
+            this.hub.broadcast({ type: 'session/released', sessionId: session.sessionId, session: snapshot(session), reason: 'resume failed', cause: 'resume-failed' });
             throw error;
         }
     }
     /** Release all live sessions (process died or went idle): keep them resumable, settle permissions, drop the connection. */
-    releaseAll(reason) {
+    releaseAll(reason, cause) {
         this.clearIdleTimer();
         for (const session of [...this.sessions.values()]) {
             // A session already being closed is `closeSession`'s to delete. Marking
@@ -1005,7 +1005,7 @@ export class AgentBridge {
             session.released = true;
             this.settlePermissions(session);
             this.released.set(session.sessionId, session);
-            this.hub.broadcast({ type: 'session/released', sessionId: session.sessionId, session: snapshot(session), reason });
+            this.hub.broadcast({ type: 'session/released', sessionId: session.sessionId, session: snapshot(session), reason, cause });
         }
         this.sessions.clear();
         this.acpIndex.clear();
@@ -4654,7 +4654,7 @@ export class BridgeManager {
         // here (their `runPrompt` promise also rejects into settle, but this also
         // covers a promise the connection teardown leaves pending).
         this.disposeTurnStreamsOf(controller => controller.session.agentId === bridge.def.id);
-        bridge.releaseAll(reason);
+        bridge.releaseAll(reason, 'died');
     }
     agentViews() {
         return [...this.defsMap.values()].map(def => (this.bridges.get(def.id) ?? this.makeBridge(def, () => { })).view());
@@ -5370,7 +5370,7 @@ export class BridgeManager {
             // rejection does not broadcast a second `turn/end` for a turn already
             // finalized by the watchdog (`LiveSession.reclaimedTurnSeq`).
             session.reclaimedTurnSeq = session.turnSeq;
-            bridge.releaseAll('agent did not acknowledge the stalled turn');
+            bridge.releaseAll('agent did not acknowledge the stalled turn', 'stalled');
             session.orphanPromptTurnSeq = undefined;
             return { ok: true };
         }

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,
@@ -242,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; }
 }
@@ -726,6 +737,17 @@ 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') {
@@ -835,6 +857,12 @@ export function AcpSettingsSection(props) {
     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 = () => {
@@ -855,7 +883,7 @@ export function AcpSettingsSection(props) {
         && 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
+                                        : _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);
@@ -864,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,6 +39,8 @@ 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;
@@ -339,6 +341,8 @@ export class AcpStore {
         blocks: [],
         permissions: [],
         busy: false,
+        logs: [],
+        logUnread: 0,
         detectedAgents: [...DEFAULT_KNOWN_PRESETS],
         detecting: false,
         modelCatalogs: {},
@@ -360,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();
@@ -445,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
@@ -1628,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) });
     }
@@ -1635,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': {
@@ -1666,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);
@@ -1681,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();
             }
@@ -1698,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 } : {}),
@@ -1705,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();
             }

package/lib/client.js

@@ -322,6 +322,8 @@ window.__ModuleLoader__.load({
 				blocks: [],
 				permissions: [],
 				busy: false,
+				logs: [],
+				logUnread: 0,
 				detectedAgents: [...DEFAULT_KNOWN_PRESETS],
 				detecting: false,
 				modelCatalogs: {},
@@ -343,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();
@@ -429,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
@@ -1479,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) {
@@ -1510,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);
@@ -1522,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();
 					}
@@ -1533,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();
 					}
@@ -2921,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; }
 }
@@ -3449,6 +3500,19 @@ 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}`);
@@ -3594,6 +3658,13 @@ window.__ModuleLoader__.load({
 			(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 = () => {
@@ -3760,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"
+								})]
 							})
 						]
 					}),
@@ -4011,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", {