@xmanrui/dsh-im 4.23.0 → 4.24.1

package/plugin-src/client/i18n.js

@@ -45,6 +45,8 @@ const EN = Object.freeze({
   'IM机器人设置': 'IM bot settings',
   'IM 面板加载失败': 'Could not load the IM panel',
   '更多机器人设置': 'More bot settings',
+  '更多设置': 'More settings',
+  '常用配置': 'Common settings',
   '机器人设置': 'Bot settings',
   '机器人设置页签': 'Bot settings tabs',
   '投递设置': 'Delivery settings',
@@ -130,6 +132,8 @@ const EN = Object.freeze({
   '已安装版本': 'Installed version',
   '目标 profile': 'Target profile',
   '目标版本': 'Target version',
+  '最新版本': 'Latest version',
+  '上次更新目标': 'Previous update target',
   '无法确认': 'Unknown',
   '发现新版本': 'Update available',
   '已是最新版本': 'Up to date',
@@ -143,6 +147,7 @@ const EN = Object.freeze({
   '更新已生效': 'Updated version is active',
   '更新失败': 'Update failed',
   '更新请求失败': 'Update request failed',
+  '暂时无法安装更新': 'Update installation is unavailable',
   '仅更新 DSH-IM。安装完成后需手动重启后台；本功能不会自动重启或主动刷新页面。': 'Only DSH-IM will be updated. Restart the backend manually after installation. This feature does not automatically restart it or initiate a page refresh.',
   '当前是源码或链接安装，只能检查版本；请手动更新源码，或迁移到 npm 安装。': 'This is a source or linked installation. You can check versions, but must update the source manually or migrate to an npm installation.',
   '无法确认当前 profile，请在对应的 Harness 环境中手动更新。': 'The current profile could not be identified. Update manually in the corresponding Harness environment.',
@@ -262,11 +267,13 @@ const EN = Object.freeze({
   '查看分步直推说明': 'View step push help',
   '开启后逐步推送工具调用与过程说明': 'Push tool calls and process notes step by step',
   '任务过程展示': 'Task progress display',
-  '设置任务执行过程的呈现方式：不显示、实时卡片或逐步消息': 'Choose how the execution is presented: hidden, one live card, or step-by-step messages',
+  '设置任务执行过程的呈现方式：不显示、原生直播、实时卡片或逐步消息': 'Choose how execution is presented: hidden, native live process, one live card, or step-by-step messages',
   '不显示过程（只发送最终答案）': 'Hide the process (send the final answer only)',
+  '实时直播（飞书原生思考过程）': 'Live process (native Feishu thinking process)',
   '实时过程卡（全程一张卡片动态更新）': 'Live process card (one card updated throughout)',
   '逐步直播（每一步单独发一条消息）': 'Step-by-step feed (one message per step)',
   '适合日常问答：执行过程中不显示工具调用等中间步骤，只回复最终结果': 'For everyday Q&A: tool calls and other interim steps stay hidden, only the final result is replied',
+  '使用飞书原生思考过程展示推理、工具调用与结果，最终答案单独发送': 'Use Feishu’s native thinking process for reasoning, tool calls, and results, then send the final answer separately',
   '推荐长任务使用：过程与最终答案都在同一张卡片里实时更新，不刷屏': 'Recommended for long tasks: the process and the final answer update live in one card without flooding the chat',
   '每一步都单独发一条消息（含工具调用和过程说明）；注意长任务会连续发送较多消息': 'Every step is sent as its own message (including tool calls and notes); long tasks may send many messages in a row',
   '分步直推设置保存失败，请重试。': 'Could not save the step push setting. Try again.',
@@ -667,6 +674,11 @@ const EN = Object.freeze({
   '接入 Telegram 机器人': 'Connect a Telegram bot',
   '先通过 @BotFather 获取 Bot Token，再在这里完成接入。': 'Get a Bot Token from @BotFather, then connect it here.',
   '填写 @BotFather 生成的 Bot Token': 'Enter the Bot Token from @BotFather',
+  '会话行为': 'Conversation behavior',
+  '思考过程留痕': 'Thinking traces',
+  '实时显示思考步骤与工具调用，最终答案单独成条': 'Show thinking steps and tool calls as they happen; the final answer arrives as its own message',
+  '请提交有效的思考过程留痕设置。': 'Submit a valid thinking-traces setting.',
+  '正在使用{name}…': 'Using {name}…',
   '访问模式': 'Access mode',
   'Telegram 访问模式': 'Telegram access mode',
   '查看 Telegram 访问模式说明': 'View Telegram access mode details',

package/plugin-src/client/index.js

@@ -324,8 +324,16 @@ export function IMSettingsTab({
           'aria-label': 'dsh-im GitHub',
           'aria-describedby': githubTooltipId,
         },
-        h('span', null, 'GitHub'),
-        h('span', { className: 'dim-githubArrow', 'aria-hidden': 'true' }, '↗')),
+        h('svg', {
+          width: 18,
+          height: 18,
+          viewBox: '0 0 16 16',
+          fill: 'currentColor',
+          focusable: 'false',
+          'aria-hidden': 'true',
+        }, h('path', {
+          d: 'M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82a7.65 7.65 0 0 1 2-.27c.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8Z',
+        }))),
         h('span', {
           id: githubTooltipId,
           className: 'dim-githubTooltip',

package/plugin-src/client/styles.js

@@ -93,10 +93,10 @@ const CSS = String.raw`
 .dim-updateFooter .dim-updateButton:first-child { margin-right: auto; }
 .dim-updatePrimary, .dim-updatePrimary:hover:not(:disabled) { border-color: var(--dsw-alias-state-business-primary, #3370ff); color: #fff; background: var(--dsw-alias-state-business-primary, #3370ff); }
 .dim-githubAction { position: relative; display: inline-flex; flex: none; }
-.dim-githubLink { min-height: 30px; display: inline-flex; align-items: center; gap: 5px; flex: none; padding: 0 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-layer-1, #fff); font-size: 12px; line-height: normal; font-weight: 560; text-decoration: none; transition: border-color .15s ease, color .15s ease, background .15s ease; }
+.dim-githubLink { width: 30px; height: 30px; display: grid; place-items: center; flex: none; padding: 0; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-layer-1, #fff); text-decoration: none; transition: border-color .15s ease, color .15s ease, background .15s ease; }
+.dim-githubLink svg { display: block; }
 .dim-githubLink:hover { border-color: #aeb3bb; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-githubLink:focus-visible { outline: 2px solid color-mix(in srgb, var(--dim-blue) 70%, white); outline-offset: 2px; }
-.dim-githubArrow { font-size: 13px; line-height: 1; }
 .dim-githubTooltip { position: absolute; top: calc(100% + 8px); right: 0; z-index: 20; width: max-content; max-width: min(220px, 80vw); padding: 6px 9px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 8px 24px rgb(31 35 41 / 14%); font-size: 11px; line-height: 16px; font-weight: 500; white-space: nowrap; opacity: 0; visibility: hidden; transform: translateY(-3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
 .dim-githubAction:hover .dim-githubTooltip, .dim-githubAction:focus-within .dim-githubTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
 .dim-generalSettingsAction { position: relative; display: inline-flex; flex: none; }
@@ -417,10 +417,15 @@ const CSS = String.raw`
 .dim-panel .dim-botCardBody { position: relative; min-width: 0; width: 100%; max-width: 100%; padding: 12px 8px; }
 .dim-collapsibleAccount { min-width: 0; display: flex; flex-direction: column; }
 .dim-collapsibleHead { min-width: 0; display: flex; align-items: center; gap: 4px; cursor: pointer; user-select: none; -webkit-user-select: none; }
-.dim-collapsibleHead:focus-visible { outline: 2px solid var(--dsw-alias-state-business-primary, #3370ff); outline-offset: 2px; border-radius: 8px; }
 .dim-collapsibleHeaderContent { min-width: 0; flex: 1 1 auto; display: flex; align-items: center; }
-.dim-collapsibleChevron { flex: 0 0 auto; display: inline-flex; align-items: center; justify-content: center; width: 9px; height: 9px; border-right: 1.6px solid var(--dsw-alias-label-tertiary, #8f959e); border-bottom: 1.6px solid var(--dsw-alias-label-tertiary, #8f959e); transform: rotate(-45deg); transition: transform .22s cubic-bezier(.4, 0, .2, 1); transform-origin: 50% 50%; }
-.dim-collapsibleAccount.is-open .dim-collapsibleChevron { transform: rotate(45deg); }
+/* Keep the original header footprint; center both icons with equal side space. */
+.dim-accountSettingsToggle { flex: none; width: 45px; height: 32px; display: inline-flex; gap: 5px; align-items: center; justify-content: center; padding: 0; border: 0; border-radius: 8px; color: var(--dsw-alias-state-business-primary, #3370ff); background: color-mix(in srgb, var(--dsw-alias-state-business-primary, #3370ff) 8%, var(--dsw-alias-bg-layer-1, #fff)); cursor: pointer; }
+.dim-accountSettingsToggle > svg { flex: none; display: block; }
+.dim-accountSettingsToggle:hover { background: color-mix(in srgb, var(--dsw-alias-state-business-primary, #3370ff) 14%, var(--dsw-alias-bg-layer-1, #fff)); }
+.dim-accountSettingsToggle:focus-visible { outline: 2px solid var(--dsw-alias-state-business-primary, #3370ff); outline-offset: 2px; }
+.dim-collapsibleChevron { width: 12px; height: 16px; transition: transform .22s cubic-bezier(.4, 0, .2, 1); transform-origin: 50% 50%; }
+.dim-accountSettingsToggle[aria-expanded="true"] .dim-collapsibleChevron { transform: rotate(180deg); }
+.dim-accountSettingsHeader { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-top: 12px; padding-top: 8px; border-top: 1px solid var(--dsw-alias-border-l2, #e5e6eb); color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; }
 /* Animate height without measuring content; hide collapsed controls from focus and accessibility. */
 .dim-collapsibleBody { display: grid; grid-template-rows: 0fr; transition: grid-template-rows .22s cubic-bezier(.4, 0, .2, 1); }
 .dim-collapsibleAccount.is-open > .dim-collapsibleBody { grid-template-rows: 1fr; }
@@ -445,11 +450,10 @@ const CSS = String.raw`
 .dim-panel .dim-botCard .dim-healthDot[data-tone="warning"] { background: var(--dsw-alias-state-warn-primary, #d97706); }
 .dim-panel .dim-botCard .dim-healthDot[data-tone="error"] { background: var(--dsw-alias-state-error-primary, #d54941); }
 .dim-botSettingsAction { position: relative; flex: none; display: inline-flex; }
-.dim-botSettingsButton { width: 32px; height: 32px; display: grid; place-items: center; padding: 0; border: 0; border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: transparent; cursor: pointer; transition: color .15s ease, background .15s ease; }
+.dim-botSettingsButton { min-height: 32px; display: inline-flex; align-items: center; gap: 6px; padding: 0 6px; border: 0; border-radius: 8px; color: var(--dsw-alias-state-business-primary, #3370ff); background: transparent; font: inherit; font-size: 12px; white-space: nowrap; cursor: pointer; transition: color .15s ease, background .15s ease; }
 .dim-botSettingsButton:hover { color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #eef0f3); }
 .dim-botSettingsButton:focus-visible { outline: 2px solid var(--dsw-alias-state-business-primary, #3370ff); outline-offset: 2px; }
-.dim-botSettingsTooltip { position: absolute; top: calc(100% + 6px); right: 0; z-index: 30; width: max-content; padding: 6px 9px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 8px 24px rgb(31 35 41 / 14%); font-size: 11px; line-height: 16px; opacity: 0; visibility: hidden; transform: translateY(-3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
-.dim-botSettingsAction:hover .dim-botSettingsTooltip, .dim-botSettingsAction:focus-within .dim-botSettingsTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
+.dim-moreSettingsChevron { width: 6px; height: 6px; margin-right: 2px; border-right: 1.5px solid currentColor; border-bottom: 1.5px solid currentColor; transform: rotate(-45deg); }
 .dim-deliveryPage { min-width: 0; display: grid; }
 .dim-deliveryHeader { min-width: 0; display: flex; align-items: center; justify-content: space-between; gap: 16px; }
 .dim-botSettingsTabsBar { min-width: 0; margin-top: 10px; border-bottom: 1px solid var(--dsw-alias-border-l2, #dfe1e5); }

package/plugin-src/client/update-panel.js

@@ -72,14 +72,17 @@ function summary(snapshot, action, error) {
   if (snapshot?.job?.state === 'restart-required' || snapshot?.blockedReason === 'pending-restart') {
     return '已安装，待手动重启';
   }
-  if (snapshot?.job?.state === 'completed') return '更新已生效';
-  if (snapshot?.job?.state === 'failed') return '更新失败';
-  if (snapshot?.job?.state === 'interrupted') return '上次更新已中断，请检查安装状态后重试。';
   if (error) return '更新请求失败';
+  if (!snapshot?.job?.recoverable) {
+    if (snapshot?.job?.state === 'failed') return '更新失败';
+    if (snapshot?.job?.state === 'interrupted') return '上次更新已中断，请检查安装状态后重试。';
+  }
+  if (snapshot?.blockedReason === 'no-update') return '当前版本无需更新';
+  if (snapshot?.blockedReason) return '暂时无法安装更新';
   if (snapshot?.canInstall) return '发现新版本';
   if (snapshot?.checkedAt && snapshot.latestVersion === snapshot.runningVersion) return '已是最新版本';
-  if (snapshot?.blockedReason === 'no-update') return '当前版本无需更新';
   if (snapshot?.checkedAt) return '已获取 npm 最新版本';
+  if (snapshot?.job?.state === 'completed') return '更新已生效';
   return '检查 npm 最新版本，不会自动安装。';
 }
 
@@ -102,7 +105,7 @@ function manualUpdateCommand(snapshot) {
   const targets = [
     snapshot.latestVersion,
     pendingRestart ? snapshot.installedVersion : null,
-    snapshot.job?.state !== 'completed' ? snapshot.job?.targetVersion : null,
+    snapshot.job?.state !== 'completed' && !snapshot.job?.recoverable ? snapshot.job?.targetVersion : null,
   ].filter(validVersion);
   // Keep a known target pinned, and never suggest downgrading an installed/running version.
   const version = targets.length
@@ -394,9 +397,12 @@ export function UpdatePanel({ rpcCall, clientVersion, onStatus }) {
   const blocked = BLOCKED_REASONS[snapshot?.blockedReason] ?? ERROR_MESSAGES[snapshot?.blockedReason];
   const canConfirm = snapshot?.canInstall && snapshot.checkId && !activeJob && !restartRequired;
   const versionsDiffer = snapshot && clientVersion && snapshot.runningVersion !== clientVersion;
-  const failedJob = ['failed', 'interrupted'].includes(snapshot?.job?.state);
+  const failedJob = ['failed', 'interrupted'].includes(snapshot?.job?.state) && !snapshot.job.recoverable;
   const jobMessage = snapshot?.job?.message;
-  const targetVersion = snapshot?.job?.targetVersion;
+  const targetVersion = activeJob || restartRequired ? snapshot?.job?.targetVersion : null;
+  const historicalTargetVersion = !activeJob && !restartRequired ? snapshot?.job?.targetVersion : null;
+  const latestVersion = !activeJob && !restartRequired && !error && snapshot?.checkedAt
+    ? snapshot.latestVersion : null;
   const manualCommand = manualUpdateCommand(snapshot);
   const buttonLabel = action === 'checking' ? '检查中…'
     : action === 'starting' || activeJob ? '正在更新…'
@@ -413,7 +419,7 @@ export function UpdatePanel({ rpcCall, clientVersion, onStatus }) {
       onClick: () => {
         setOpen(true);
         if (restartRequired) void refreshStatus();
-        else if (!snapshot?.canInstall && !snapshot?.job) void check();
+        else if (!snapshot?.canInstall && !activeJob && !uncertainInstall) void check();
       },
     }, buttonLabel, buttonLabel === '更新至' ? ` v${snapshot.latestVersion}` : null),
     open ? h(UpdateDialog, { onClose: () => setOpen(false) },
@@ -425,6 +431,10 @@ export function UpdatePanel({ rpcCall, clientVersion, onStatus }) {
                 h('dt', null, '已安装版本'), h('dd', null, `v${snapshot.installedVersion}`)) : null,
           targetVersion ? h(React.Fragment, null,
             h('dt', null, '目标版本'), h('dd', null, `v${targetVersion}`)) : null,
+          latestVersion ? h(React.Fragment, null,
+            h('dt', null, '最新版本'), h('dd', null, `v${latestVersion}`)) : null,
+          historicalTargetVersion ? h(React.Fragment, null,
+            h('dt', null, '上次更新目标'), h('dd', null, `v${historicalTargetVersion}`)) : null,
           h('dt', null, '目标 profile'), h('dd', null, snapshot?.profileName ?? '无法确认')),
         h('div', {
           className: `dim-updateStatus${error || failedJob ? ' dim-updateStatusError' : ''}`,

package/plugin-src/host/channels/shared/rpc.mjs

@@ -15,6 +15,7 @@ import {
   validAgentPresetPayload,
 } from './agent-preset-rpc.mjs';
 import { SET_MODEL_ENDPOINT, validModelPayload } from './model-setting-rpc.mjs';
+import { SET_THINKING_TRACES_ENDPOINT, validThinkingTracesPayload } from './thinking-traces-rpc.mjs';
 
 export const TOKEN_BOT_ENDPOINTS = Object.freeze({
   status: 'connection.status',
@@ -27,6 +28,7 @@ export const TOKEN_BOT_ENDPOINTS = Object.freeze({
   setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
   setAccessPolicy: SET_ACCESS_POLICY_ENDPOINT,
   setAlias: SET_ALIAS_ENDPOINT,
+  setThinkingTraces: SET_THINKING_TRACES_ENDPOINT,
 });
 
 const ENDPOINTS = Object.freeze(Object.values(TOKEN_BOT_ENDPOINTS));
@@ -97,6 +99,10 @@ function payloadFailure(endpoint, payload) {
     return validAliasPayload(payload)
       ? null : '请输入有效的别名（最多 80 个字符）。';
   }
+  if (endpoint === TOKEN_BOT_ENDPOINTS.setThinkingTraces) {
+    return validThinkingTracesPayload(payload)
+      ? null : '请提交有效的思考过程留痕设置。';
+  }
   return 'Unknown bot endpoint.';
 }
 
@@ -194,6 +200,9 @@ export function createTokenBotRpcHandler(controller, { channel }) {
       } else if (endpoint === TOKEN_BOT_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await controller.updateAgentPreset(payload.botId, payload.agentPreset);
+      } else if (endpoint === TOKEN_BOT_ENDPOINTS.setThinkingTraces) {
+        if (typeof controller.setThinkingTraces !== 'function') throw new Error('Thinking traces update is unavailable');
+        value = await controller.setThinkingTraces(payload.botId, payload.thinkingTraces);
       } else {
         value = await controller.deleteBot(payload.botId);
       }

package/plugin-src/host/channels/shared/thinking-traces-rpc.mjs

@@ -0,0 +1,11 @@
+export const SET_THINKING_TRACES_ENDPOINT = 'bot.thinking-traces.set';
+
+export function validThinkingTracesPayload(payload) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)
+    || Reflect.ownKeys(payload).length !== 2
+    || !Object.hasOwn(payload, 'botId') || !Object.hasOwn(payload, 'thinkingTraces')
+    || typeof payload.botId !== 'string'
+    || !/^[A-Za-z0-9_-]{1,128}$/.test(payload.botId)
+    || typeof payload.thinkingTraces !== 'boolean') return false;
+  return true;
+}

package/plugin-src/host/modern-harness-api.mjs

@@ -382,7 +382,7 @@ class ModernHarnessApi {
       return;
     }
     if (frame.type !== 'chunk' || frame.index !== stream.entries.length) return;
-    stream.entries.push({
+    const entry = {
       type: 'transient',
       event: {
         type: 'assistant/chunk',
@@ -392,7 +392,12 @@ class ModernHarnessApi {
         time: frame.time,
         data: { turn: stream.turn, step: stream.step, chunk: frame.chunk },
       },
-    });
+    };
+    stream.entries.push(entry);
+    // History only exposes these transient chunks while the attempt is open.
+    // Broadcast each one as it arrives so live IM renderers cannot miss a
+    // short reasoning phase that starts and commits between two history polls.
+    this.#broadcast({ type: 'session/event', sessionId, event: entry.event });
   }
 
   #withAssistantStream(sessionId, entries) {

package/plugin-src/host/update-service.mjs

@@ -113,7 +113,7 @@ function processAlive(pid) {
 function publicJob(job) {
   if (!job) return null;
   const { id, state, targetVersion, message } = job;
-  return { id, state, targetVersion, message };
+  return { id, state, targetVersion, message, recoverable: job.recoverable === true };
 }
 
 /** One update job per profile. Persist intent before starting pnpm, and never apply a restart here. */
@@ -158,27 +158,32 @@ export function createUpdateService({
     if (!JOB_STATES.has(job.state) || typeof job.id !== 'string' || !semver.valid(job.targetVersion)) {
       throw updateError('state-unavailable');
     }
-    if (ACTIVE_STATES.has(job.state) && job.id !== activeJob?.id) {
+    // Recovery is derived from the current installation, never a persisted flag.
+    job = { ...job, recoverable: false };
+    const historical = job.id !== activeJob?.id;
+    if (ACTIVE_STATES.has(job.state) && historical) {
       if (lock === NO_LOCK || lock?.id !== job.id || !processAlive(lock?.pid)) {
         job = { ...job, state: 'interrupted', message: 'recovery-required' };
       }
     }
-    if (job.id !== activeJob?.id && !ACTIVE_STATES.has(job.state)) {
-      if (lock !== NO_LOCK) return { ...job, state: 'interrupted', message: 'recovery-required' };
-      // A later Host can retry after a verified manual repair. Never infer this
-      // from version equality while an old process lock is still present.
-      if (['failed', 'interrupted'].includes(job.state) && environment.packageValid === true
-        && environment.installedVersion === runningVersion && !environment.blockedReason) {
-        return job.targetVersion === runningVersion
-          ? { ...job, state: 'completed', message: 'recovered' }
-          : { ...job, recoverable: true };
-      }
+    if (historical && !ACTIVE_STATES.has(job.state) && lock !== NO_LOCK) {
+      return { ...job, state: 'interrupted', message: 'recovery-required' };
     }
     if (job.state === 'restart-required' || job.state === 'completed') {
       if (environment.installedVersion !== job.targetVersion || environment.packageValid !== true) {
-        return { ...job, state: 'interrupted', message: 'installation-changed' };
+        job = { ...job, state: 'interrupted', message: 'installation-changed' };
+      } else {
+        job = { ...job, state: runningVersion === job.targetVersion ? 'completed' : 'restart-required' };
       }
-      return { ...job, state: runningVersion === job.targetVersion ? 'completed' : 'restart-required' };
+    }
+    // Reconcile after deriving the job state so an external upgrade or rollback
+    // can also recover. Keep history read-only and do not claim its target ran.
+    if (historical && lock === NO_LOCK && ['failed', 'interrupted'].includes(job.state)
+      && environment.packageValid === true && environment.eligible === true
+      && environment.installedVersion === runningVersion && !environment.blockedReason) {
+      return job.targetVersion === runningVersion
+        ? { ...job, state: 'completed', message: 'recovered' }
+        : { ...job, recoverable: true };
     }
     return job;
   }

package/scripts/verify-package.mjs

@@ -142,22 +142,28 @@ if (client.includes('settings.plugins.tab') || clientSources.includes('settings.
   throw new Error('client source or bundle still contains the legacy Plugins-tab settings entry');
 }
 // Connections still have no channel-enable toggle. Checkable inputs are owned
-// only by the shared context editor and the saved-target Session sync row.
+// only by the shared context editor, the saved-target Session sync row, the
+// email settings, and the Telegram thinking-traces block.
 // The context editor contains one switch template and one mapped field-input
-// template; the delivery target adds one ordinary checkbox template.
+// template; the delivery target adds one ordinary checkbox template; the
+// Telegram thinking-traces block adds one ordinary checkbox template.
 const contextEditorSource = await readFile(resolve(root, 'plugin-src/client/context-enhancement.js'), 'utf8');
 const deliverySettingsSource = await readFile(resolve(root, 'plugin-src/client/delivery-settings.js'), 'utf8');
 const emailSettingsSource = await readFile(resolve(root, 'plugin-src/client/channels/email/index.js'), 'utf8');
+const thinkingTracesSource = await readFile(resolve(root, 'plugin-src/client/channels/telegram/thinking-traces.js'), 'utf8');
 const otherClientSources = clientSources
   .replace(contextEditorSource, '')
   .replace(deliverySettingsSource, '')
-  .replace(emailSettingsSource, '');
+  .replace(emailSettingsSource, '')
+  .replace(thinkingTracesSource, '');
 if (/role:\s*["']switch|type:\s*["']checkbox/.test(otherClientSources)
   || (deliverySettingsSource.match(/type:\s*["']checkbox["']/g) ?? []).length !== 1
   || /role:\s*["']switch["']/u.test(deliverySettingsSource)
+  || (thinkingTracesSource.match(/type:\s*["']checkbox["']/g) ?? []).length !== 1
+  || /role:\s*["']switch["']/u.test(thinkingTracesSource)
   || (client.match(/role:\s*["']switch["']/g) ?? []).length !== 1
-  || (client.match(/type:\s*["']checkbox["']/g) ?? []).length !== 3) {
-  throw new Error('checkable inputs must be limited to context enhancement and Session sync');
+  || (client.match(/type:\s*["']checkbox["']/g) ?? []).length !== 4) {
+  throw new Error('checkable inputs must be limited to context enhancement, Session sync, email settings, and the Telegram thinking-traces toggle');
 }
 for (const marker of ['bot.context-enhancement.set', '<dsh_im_source>', '<dsh_im_source_guidance>']) {
   if (!host.includes(marker) || !client.includes(marker)) {

package/src/channels/email/email-runtime.mjs

@@ -200,8 +200,15 @@ export function normalizeEmail(parsed, { address, state } = {}) {
       // attachment type under any other key is silently dropped.
       ...(attachment.contentType ? { mediaType: String(attachment.contentType) } : {}),
       // The bridge streams files via a loader so large attachments are not
-      // held in memory until they are actually needed.
-      load: async () => attachment.content,
+      // held in memory until they are actually needed. Transports differ in
+      // what `content` is: IMAP hands over a Buffer (already fetched with the
+      // body), while the Agent mailbox can only fetch bytes on demand and so
+      // exposes a function. Returning that function unchanged made the loader
+      // resolve to a function, which the inbound-file layer rejects as
+      // `inbound-file-data-invalid` — the download never happened.
+      load: async () => (typeof attachment.content === 'function'
+        ? attachment.content()
+        : attachment.content),
     })),
     reactionTarget: null,
     replyTarget: {

package/src/channels/email/transports/agent-mail.mjs

@@ -301,10 +301,21 @@ export class AgentMailTransport {
     this.#connected = false;
   }
 
-  /** The newest id, used to seed a cursor. */
+  /**
+   * The newest id, used to seed a cursor.
+   *
+   * Reads the list summary only. Going through `listMessages` without an
+   * allowlist meant "no filter", so seeding a cursor downloaded the body of the
+   * newest message — mail the policy may well refuse, fetched before anyone
+   * asked for it. The newest id is in the first summary already.
+   */
   async latestUid() {
-    const listed = await this.listMessages({ afterUid: null, limit: 1 });
-    return listed.length > 0 ? listed[0].uid : 0;
+    const { document } = await this.#call(
+      ['message', '+list', '--dir', INBOX, '--limit', '1'],
+      { signal: this.#signal },
+    );
+    const items = Array.isArray(document?.data?.data) ? document.data.data : [];
+    return String(items[0]?.message_id ?? '').trim() || 0;
   }
 
   /**