dsh-monkeyai-sessions 0.1.2 → 0.1.4

package/README.md

@@ -39,7 +39,7 @@ All three request `device:connect`, `session:read`, and `session:control` throug
 
 ## Sessions
 
-Full conversation history is loaded over the runtime's HTTP read channel (`POST {http_base}/read/session` with `_monkeyai/session/messages`, paginated by cursor) instead of the bounded ACP `session/load` replay, so long sessions show every turn including the latest replies. While a turn is running the composer shows a stop button that sends `session/cancel`; the model switcher uses `_monkeyai/session/model/set` on the live session connection. Assistant messages render lightweight markdown (code blocks, inline code, bold, headings, lists).
+Full conversation history is loaded over the runtime's HTTP read channel (`POST {http_base}/read/session` with `_monkeyai/session/messages`, paginated by cursor) instead of the bounded ACP `session/load` replay, so long sessions show every turn including the latest replies. After mounting the session with the same `historyHTTP` capabilities as the MonkeyAI client, the panel subscribes to ACP live updates: messages and assistant chunks started in the MonkeyAI desktop client appear as they stream, without refreshing. For large replies persisted by the runtime, `history_changed` triggers a cursor-based HTTP delta refresh and replaces any partial snapshot. A status badge next to the session title shows the turn state (running / idle / error / interrupted), driven by the runtime's `_monkeyai/session/state` notifications, so turns started from the MonkeyAI desktop client also show as running; when the panel opens while a turn is already in flight, the host fetches the current state to seed the badge. While a turn is running (from either side) the composer shows a stop button that sends `session/cancel`; the model switcher uses `_monkeyai/session/model/set` on the live session connection. Assistant messages render lightweight markdown (code blocks, inline code, bold, headings, lists).
 
 ## Installation
 
@@ -61,7 +61,7 @@ From a checkout:
 npm install
 npm run build
 npm pack
-dsh plugin --profile web add ./dsh-monkeyai-sessions-0.1.2.tgz
+dsh plugin --profile web add ./dsh-monkeyai-sessions-0.1.4.tgz
 ```
 
 Verified against a real DSH `0.2.2-rc.1` web profile and a live MonkeyAI runtime: authorization, full history loading, prompt delivery, model switching, and turn cancellation all work end to end.

package/README.zh.md

@@ -28,7 +28,7 @@ https://artenx.github.io/dsh-monkeyai-sessions/index.json
 npm install
 npm run build
 npm pack
-dsh plugin --profile web add ./dsh-monkeyai-sessions-0.1.2.tgz
+dsh plugin --profile web add ./dsh-monkeyai-sessions-0.1.4.tgz
 ```
 
 已在真实的 DSH `0.2.2-rc.1` web profile 与在线 MonkeyAI runtime 上端到端验证：授权、完整历史加载、指令下发、模型切换、回合取消均正常工作。
@@ -45,9 +45,9 @@ dsh plugin --profile web add ./dsh-monkeyai-sessions-0.1.2.tgz
 
 ## 会话能力
 
-完整对话历史通过 runtime 的 HTTP 读取通道加载（`POST {http_base}/read/session`，方法 `_monkeyai/session/messages`，按游标翻页），而不是 ACP `session/load` 的有界回放，因此长会话能看到每一轮内容，包括最新回复。
+完整对话历史通过 runtime 的 HTTP 读取通道加载（`POST {http_base}/read/session`，方法 `_monkeyai/session/messages`，按游标翻页），而不是 ACP `session/load` 的有界回放，因此长会话能看到每一轮内容，包括最新回复。会话使用与 MonkeyAI 客户端相同的 `historyHTTP` 能力挂载后，面板会订阅 ACP 实时更新：在 MonkeyAI 桌面客户端发起的用户消息和助手回复都会边生成边显示，无需刷新。对于 runtime 先持久化再通知的超大回复，收到 `history_changed` 后会按游标增量读取，并用完整快照补齐部分内容。
 
-回合执行期间输入框旁会显示停止按钮，点击发送 `session/cancel`；模型切换在会话自己的连接上调用 `_monkeyai/session/model/set`。助手消息支持轻量 Markdown 渲染（代码块、行内代码、粗体、标题、列表）。
+会话标题旁会显示会话状态徽章（进行中 / 空闲 / 出错 / 已中断），数据来自 runtime 广播的 `_monkeyai/session/state` 通知，因此由 MonkeyAI 桌面客户端发起的回合同样会显示为「进行中」——打开面板时如果回合已经在跑，Host 会主动读取一次当前状态补齐。回合执行期间（无论哪一端发起）输入框旁会显示停止按钮，点击发送 `session/cancel`；模型切换在会话自己的连接上调用 `_monkeyai/session/model/set`。助手消息支持轻量 Markdown 渲染（代码块、行内代码、粗体、标题、列表）。
 
 ## 界面说明
 

package/client.js

@@ -331,6 +331,12 @@ window.__ModuleLoader__.load({
       failed: "\u5931\u8D25",
       cancelled: "\u5DF2\u53D6\u6D88"
     });
+    var SESSION_STATUS_LABEL = Object.freeze({
+      running: "\u8FDB\u884C\u4E2D",
+      idle: "\u7A7A\u95F2",
+      error: "\u51FA\u9519",
+      interrupted: "\u5DF2\u4E2D\u65AD"
+    });
     function contentText(content) {
       const blocks = Array.isArray(content) ? content : content === void 0 || content === null ? [] : [content];
       const parts = [];
@@ -495,6 +501,12 @@ window.__ModuleLoader__.load({
           continue;
         }
         if (frame.type === "notification" && typeof frame.method === "string" && frame.method.startsWith("_monkeyai/")) {
+          if (frame.method === "_monkeyai/session/state") {
+            const status = frame.data?.state?.status;
+            if (typeof status === "string" && SESSION_STATUS_LABEL[status]) {
+              entries.push({ kind: "system", label: `\u4F1A\u8BDD\u72B6\u6001\uFF1A${SESSION_STATUS_LABEL[status]}`, key: `sys-state:${entries.length}` });
+            }
+          }
           continue;
         }
         if (frame.type === "error") {
@@ -808,6 +820,7 @@ window.__ModuleLoader__.load({
       const [visibleCount, setVisibleCount] = useState(RECENT_LIMIT);
       const [turnActive, setTurnActive] = useState(false);
       const [stopping, setStopping] = useState(false);
+      const [sessionStatus, setSessionStatus] = useState("");
       const [signInEmail, setSignInEmail] = useState("");
       const [signInPassword, setSignInPassword] = useState("");
       const streamRef = useRef(null);
@@ -1048,6 +1061,7 @@ window.__ModuleLoader__.load({
         setLastDelivery(void 0);
         setTurnActive(false);
         setStopping(false);
+        setSessionStatus("");
         setError("");
         setAnswerText("");
         setCurrentModel("");
@@ -1090,6 +1104,14 @@ window.__ModuleLoader__.load({
             if (frame.type === "request") {
               setPendingRequests((current) => [...current.filter((item) => item.requestId !== frame.requestId), frame]);
             }
+            if (frame.type === "notification" && frame.method === "_monkeyai/session/state") {
+              const status2 = frame.data?.state?.status;
+              if (typeof status2 === "string" && SESSION_STATUS_LABEL[status2]) {
+                setSessionStatus(status2);
+                setTurnActive(status2 === "running");
+                if (status2 !== "running") setStopping(false);
+              }
+            }
             if (frame.type === "delivery") {
               const accepted = Boolean(frame.data?.accepted);
               setLastDelivery({ accepted, code: frame.data?.code, frame: frame.type });
@@ -1120,12 +1142,14 @@ window.__ModuleLoader__.load({
           setHistoryLoading(false);
           setTurnActive(false);
           setStopping(false);
+          setSessionStatus("");
         } catch (reason) {
           setStatus("\u8FDC\u7A0B\u4F1A\u8BDD\u4E0D\u53EF\u7528");
           setError(errorText(reason));
           setHistoryLoading(false);
           setTurnActive(false);
           setStopping(false);
+          setSessionStatus("");
         }
       }
       function sendPrompt() {
@@ -1636,10 +1660,26 @@ window.__ModuleLoader__.load({
                 setSessionId("");
                 setTurnActive(false);
                 setStopping(false);
+                setSessionStatus("");
                 setStatus("\u8FDC\u7A0B\u4F1A\u8BDD\u5DF2\u5173\u95ED");
               }
             }, "\u2190"),
             h("strong", { style: { flex: 1, fontSize: 13.5, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }, title }, title),
+            sessionStatus ? h(
+              "span",
+              {
+                style: {
+                  ...style.statusBadge,
+                  background: sessionStatus === "running" ? t.accentSoft : sessionStatus === "error" ? t.dangerBg : t.surfaceAlt,
+                  borderColor: sessionStatus === "running" ? t.accent : sessionStatus === "error" ? t.dangerBorder : t.border,
+                  color: sessionStatus === "running" ? t.accent : sessionStatus === "error" ? t.danger : t.text2
+                },
+                title: "\u4F1A\u8BDD\u72B6\u6001\uFF08\u542B\u8FDC\u7AEF\u5BA2\u6237\u7AEF\u53D1\u8D77\u7684\u56DE\u5408\uFF09",
+                "aria-label": `\u4F1A\u8BDD\u72B6\u6001\uFF1A${SESSION_STATUS_LABEL[sessionStatus]}`
+              },
+              sessionStatus === "running" ? h("span", { className: "mai-pulse", style: { ...style.dot, background: t.accent } }) : null,
+              SESSION_STATUS_LABEL[sessionStatus]
+            ) : null,
             h(
               "select",
               {
@@ -1823,7 +1863,7 @@ window.__ModuleLoader__.load({
             "div",
             { style: { fontSize: 11.5, color: turnActive ? t.accent : lastDelivery?.accepted ? t.success : lastDelivery?.frame === "pending" ? t.text3 : t.danger, textAlign: "right", display: "flex", alignItems: "center", justifyContent: "flex-end", gap: 6 } },
             turnActive ? h("span", { className: "mai-pulse", style: { ...style.dot, background: t.accent } }) : null,
-            turnActive ? stopping ? "\u6B63\u5728\u505C\u6B62\u5F53\u524D\u56DE\u5408\u2026" : "MonkeyAI \u6B63\u5728\u5904\u7406\u2026" : lastDelivery?.accepted ? "\u56DE\u5408\u5DF2\u7ED3\u675F" : lastDelivery?.frame === "pending" ? "\u7B49\u5F85\u6295\u9012" : "\u6295\u9012\u88AB\u62D2\u7EDD"
+            turnActive ? stopping ? "\u6B63\u5728\u505C\u6B62\u5F53\u524D\u56DE\u5408\u2026" : sessionStatus === "running" ? "MonkeyAI \u6B63\u5728\u5904\u7406\uFF08\u8FDC\u7AEF\u5BA2\u6237\u7AEF\u53D1\u8D77\uFF09\u2026" : "MonkeyAI \u6B63\u5728\u5904\u7406\u2026" : lastDelivery?.accepted ? "\u56DE\u5408\u5DF2\u7ED3\u675F" : lastDelivery?.frame === "pending" ? "\u7B49\u5F85\u6295\u9012" : "\u6295\u9012\u88AB\u62D2\u7EDD"
           ) : null
         ) : null
       );

package/lib/client-runtime.cjs

@@ -326,6 +326,12 @@ var TOOL_STATUS_LABEL = Object.freeze({
   failed: "\u5931\u8D25",
   cancelled: "\u5DF2\u53D6\u6D88"
 });
+var SESSION_STATUS_LABEL = Object.freeze({
+  running: "\u8FDB\u884C\u4E2D",
+  idle: "\u7A7A\u95F2",
+  error: "\u51FA\u9519",
+  interrupted: "\u5DF2\u4E2D\u65AD"
+});
 function contentText(content) {
   const blocks = Array.isArray(content) ? content : content === void 0 || content === null ? [] : [content];
   const parts = [];
@@ -490,6 +496,12 @@ function projectFrames(frames) {
       continue;
     }
     if (frame.type === "notification" && typeof frame.method === "string" && frame.method.startsWith("_monkeyai/")) {
+      if (frame.method === "_monkeyai/session/state") {
+        const status = frame.data?.state?.status;
+        if (typeof status === "string" && SESSION_STATUS_LABEL[status]) {
+          entries.push({ kind: "system", label: `\u4F1A\u8BDD\u72B6\u6001\uFF1A${SESSION_STATUS_LABEL[status]}`, key: `sys-state:${entries.length}` });
+        }
+      }
       continue;
     }
     if (frame.type === "error") {
@@ -803,6 +815,7 @@ function RemoteSessionPage({ api }) {
   const [visibleCount, setVisibleCount] = useState(RECENT_LIMIT);
   const [turnActive, setTurnActive] = useState(false);
   const [stopping, setStopping] = useState(false);
+  const [sessionStatus, setSessionStatus] = useState("");
   const [signInEmail, setSignInEmail] = useState("");
   const [signInPassword, setSignInPassword] = useState("");
   const streamRef = useRef(null);
@@ -1043,6 +1056,7 @@ function RemoteSessionPage({ api }) {
     setLastDelivery(void 0);
     setTurnActive(false);
     setStopping(false);
+    setSessionStatus("");
     setError("");
     setAnswerText("");
     setCurrentModel("");
@@ -1085,6 +1099,14 @@ function RemoteSessionPage({ api }) {
         if (frame.type === "request") {
           setPendingRequests((current) => [...current.filter((item) => item.requestId !== frame.requestId), frame]);
         }
+        if (frame.type === "notification" && frame.method === "_monkeyai/session/state") {
+          const status2 = frame.data?.state?.status;
+          if (typeof status2 === "string" && SESSION_STATUS_LABEL[status2]) {
+            setSessionStatus(status2);
+            setTurnActive(status2 === "running");
+            if (status2 !== "running") setStopping(false);
+          }
+        }
         if (frame.type === "delivery") {
           const accepted = Boolean(frame.data?.accepted);
           setLastDelivery({ accepted, code: frame.data?.code, frame: frame.type });
@@ -1115,12 +1137,14 @@ function RemoteSessionPage({ api }) {
       setHistoryLoading(false);
       setTurnActive(false);
       setStopping(false);
+      setSessionStatus("");
     } catch (reason) {
       setStatus("\u8FDC\u7A0B\u4F1A\u8BDD\u4E0D\u53EF\u7528");
       setError(errorText(reason));
       setHistoryLoading(false);
       setTurnActive(false);
       setStopping(false);
+      setSessionStatus("");
     }
   }
   function sendPrompt() {
@@ -1631,10 +1655,26 @@ function RemoteSessionPage({ api }) {
             setSessionId("");
             setTurnActive(false);
             setStopping(false);
+            setSessionStatus("");
             setStatus("\u8FDC\u7A0B\u4F1A\u8BDD\u5DF2\u5173\u95ED");
           }
         }, "\u2190"),
         h("strong", { style: { flex: 1, fontSize: 13.5, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }, title }, title),
+        sessionStatus ? h(
+          "span",
+          {
+            style: {
+              ...style.statusBadge,
+              background: sessionStatus === "running" ? t.accentSoft : sessionStatus === "error" ? t.dangerBg : t.surfaceAlt,
+              borderColor: sessionStatus === "running" ? t.accent : sessionStatus === "error" ? t.dangerBorder : t.border,
+              color: sessionStatus === "running" ? t.accent : sessionStatus === "error" ? t.danger : t.text2
+            },
+            title: "\u4F1A\u8BDD\u72B6\u6001\uFF08\u542B\u8FDC\u7AEF\u5BA2\u6237\u7AEF\u53D1\u8D77\u7684\u56DE\u5408\uFF09",
+            "aria-label": `\u4F1A\u8BDD\u72B6\u6001\uFF1A${SESSION_STATUS_LABEL[sessionStatus]}`
+          },
+          sessionStatus === "running" ? h("span", { className: "mai-pulse", style: { ...style.dot, background: t.accent } }) : null,
+          SESSION_STATUS_LABEL[sessionStatus]
+        ) : null,
         h(
           "select",
           {
@@ -1818,7 +1858,7 @@ function RemoteSessionPage({ api }) {
         "div",
         { style: { fontSize: 11.5, color: turnActive ? t.accent : lastDelivery?.accepted ? t.success : lastDelivery?.frame === "pending" ? t.text3 : t.danger, textAlign: "right", display: "flex", alignItems: "center", justifyContent: "flex-end", gap: 6 } },
         turnActive ? h("span", { className: "mai-pulse", style: { ...style.dot, background: t.accent } }) : null,
-        turnActive ? stopping ? "\u6B63\u5728\u505C\u6B62\u5F53\u524D\u56DE\u5408\u2026" : "MonkeyAI \u6B63\u5728\u5904\u7406\u2026" : lastDelivery?.accepted ? "\u56DE\u5408\u5DF2\u7ED3\u675F" : lastDelivery?.frame === "pending" ? "\u7B49\u5F85\u6295\u9012" : "\u6295\u9012\u88AB\u62D2\u7EDD"
+        turnActive ? stopping ? "\u6B63\u5728\u505C\u6B62\u5F53\u524D\u56DE\u5408\u2026" : sessionStatus === "running" ? "MonkeyAI \u6B63\u5728\u5904\u7406\uFF08\u8FDC\u7AEF\u5BA2\u6237\u7AEF\u53D1\u8D77\uFF09\u2026" : "MonkeyAI \u6B63\u5728\u5904\u7406\u2026" : lastDelivery?.accepted ? "\u56DE\u5408\u5DF2\u7ED3\u675F" : lastDelivery?.frame === "pending" ? "\u7B49\u5F85\u6295\u9012" : "\u6295\u9012\u88AB\u62D2\u7EDD"
       ) : null
     ) : null
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-monkeyai-sessions",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "在 DeepSeek Harness 中读取和继续 MonkeyAI 会话：查看完整对话历史、下发新指令，无缝接续之前在 MonkeyAI 客户端上的工作",
   "type": "module",
   "license": "MIT",

package/src/client/index.js

@@ -1,6 +1,6 @@
 import React from 'react'
 import { TYPERT_REMOTE } from '../remote.js'
-import { projectFrames, TOOL_STATUS_LABEL } from '../shared/projection.mjs'
+import { projectFrames, TOOL_STATUS_LABEL, SESSION_STATUS_LABEL } from '../shared/projection.mjs'
 
 const PANEL_ID = 'monkeyai-sessions'
 const MANUAL_DEVICES_KEY = 'monkeyai-sessions/manual-devices'
@@ -290,6 +290,7 @@ function RemoteSessionPage({ api }) {
   const [visibleCount, setVisibleCount] = useState(RECENT_LIMIT)
   const [turnActive, setTurnActive] = useState(false)
   const [stopping, setStopping] = useState(false)
+  const [sessionStatus, setSessionStatus] = useState('')
   const [signInEmail, setSignInEmail] = useState('')
   const [signInPassword, setSignInPassword] = useState('')
   const streamRef = useRef(null)
@@ -540,6 +541,7 @@ function RemoteSessionPage({ api }) {
     setLastDelivery(undefined)
     setTurnActive(false)
     setStopping(false)
+    setSessionStatus('')
     setError('')
     setAnswerText('')
     setCurrentModel('')
@@ -582,6 +584,14 @@ function RemoteSessionPage({ api }) {
         if (frame.type === 'request') {
           setPendingRequests(current => [...current.filter(item => item.requestId !== frame.requestId), frame])
         }
+        if (frame.type === 'notification' && frame.method === '_monkeyai/session/state') {
+          const status = frame.data?.state?.status
+          if (typeof status === 'string' && SESSION_STATUS_LABEL[status]) {
+            setSessionStatus(status)
+            setTurnActive(status === 'running')
+            if (status !== 'running') setStopping(false)
+          }
+        }
         if (frame.type === 'delivery') {
           const accepted = Boolean(frame.data?.accepted)
           setLastDelivery({ accepted, code: frame.data?.code, frame: frame.type })
@@ -612,12 +622,14 @@ function RemoteSessionPage({ api }) {
       setHistoryLoading(false)
       setTurnActive(false)
       setStopping(false)
+      setSessionStatus('')
     } catch (reason) {
       setStatus('远程会话不可用')
       setError(errorText(reason))
       setHistoryLoading(false)
       setTurnActive(false)
       setStopping(false)
+      setSessionStatus('')
     }
   }
 
@@ -1014,9 +1026,21 @@ function RemoteSessionPage({ api }) {
       h('div', { style: style.row },
         h('button', {
           type: 'button', style: { ...style.button, flexShrink: 0 }, title: '关闭会话并返回列表',
-          onClick: () => { streamRef.current?.dispose(); streamRef.current = null; setSessionId(''); setTurnActive(false); setStopping(false); setStatus('远程会话已关闭') },
+          onClick: () => { streamRef.current?.dispose(); streamRef.current = null; setSessionId(''); setTurnActive(false); setStopping(false); setSessionStatus(''); setStatus('远程会话已关闭') },
         }, '←'),
         h('strong', { style: { flex: 1, fontSize: 13.5, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }, title }, title),
+        sessionStatus ? h('span', {
+          style: {
+            ...style.statusBadge,
+            background: sessionStatus === 'running' ? t.accentSoft : sessionStatus === 'error' ? t.dangerBg : t.surfaceAlt,
+            borderColor: sessionStatus === 'running' ? t.accent : sessionStatus === 'error' ? t.dangerBorder : t.border,
+            color: sessionStatus === 'running' ? t.accent : sessionStatus === 'error' ? t.danger : t.text2,
+          },
+          title: '会话状态（含远端客户端发起的回合）',
+          'aria-label': `会话状态：${SESSION_STATUS_LABEL[sessionStatus]}`,
+        },
+          sessionStatus === 'running' ? h('span', { className: 'mai-pulse', style: { ...style.dot, background: t.accent } }) : null,
+          SESSION_STATUS_LABEL[sessionStatus]) : null,
         h('select', {
           style: { ...style.input, flex: '0 1 190px', minWidth: 130 },
           value: currentModel,
@@ -1134,7 +1158,7 @@ function RemoteSessionPage({ api }) {
                 h('path', { d: 'M8 12.5V3.5M8 3.5L4 7.5M8 3.5L12 7.5', stroke: 'currentColor', strokeWidth: 1.8, strokeLinecap: 'round', strokeLinejoin: 'round' })))),
       lastDelivery || turnActive ? h('div', { style: { fontSize: 11.5, color: turnActive ? t.accent : lastDelivery?.accepted ? t.success : lastDelivery?.frame === 'pending' ? t.text3 : t.danger, textAlign: 'right', display: 'flex', alignItems: 'center', justifyContent: 'flex-end', gap: 6 } },
         turnActive ? h('span', { className: 'mai-pulse', style: { ...style.dot, background: t.accent } }) : null,
-        turnActive ? (stopping ? '正在停止当前回合…' : 'MonkeyAI 正在处理…') : lastDelivery?.accepted ? '回合已结束' : lastDelivery?.frame === 'pending' ? '等待投递' : '投递被拒绝') : null)
+        turnActive ? (stopping ? '正在停止当前回合…' : sessionStatus === 'running' ? 'MonkeyAI 正在处理（远端客户端发起）…' : 'MonkeyAI 正在处理…') : lastDelivery?.accepted ? '回合已结束' : lastDelivery?.frame === 'pending' ? '等待投递' : '投递被拒绝') : null)
       : null)
 }
 

package/src/host/monkeyai-remote.js

@@ -689,6 +689,7 @@ export class MonkeyAIRemoteService extends TypertRemoteService {
     let reconnectsUsed = 0
     const MAX_REPLAY_RECONNECTS = 32
     let ticketValue
+    let ticketHttpBase
     let loadCompleted = false
     let currentLoadedModel = undefined
     const aborted = new Promise(resolve => {
@@ -726,10 +727,12 @@ export class MonkeyAIRemoteService extends TypertRemoteService {
     // for close detection but suppressed from the event stream to avoid
     // duplicating text the projection already folded in.
     const httpHistoryMessageIds = new Set()
-    // When the HTTP channel delivered the full history, the ACP replay adds
-    // nothing: skip session/load entirely and mount the session live.
+    // The full history was loaded over HTTP. Keep the message ids so ACP
+    // replay duplicates can be suppressed and history_changed notifications
+    // can fetch only newly persisted snapshots.
     let httpHistoryComplete = false
     let httpConfigurationRevision
+    let historyRefreshPromise = Promise.resolve()
     // history_loaded can be triggered by both the HTTP history channel and
     // the ACP load path; the stream must carry it exactly once.
     let historyLoadedEmitted = false
@@ -738,6 +741,26 @@ export class MonkeyAIRemoteService extends TypertRemoteService {
       historyLoadedEmitted = true
       emit({ type: 'history_loaded', sessionId: selectedSession, ...(model === undefined ? {} : { model }) })
     }
+    const refreshPersistedHistory = async changedMessageId => {
+      if (!ticketHttpBase || !ticketValue) return
+      const delta = await fetchSessionHistoryDelta({
+        httpBase: ticketHttpBase,
+        ticket: ticketValue,
+        sessionId: selectedSession,
+        signal,
+        knownMessageIds: httpHistoryMessageIds,
+        changedMessageId,
+      })
+      if (Number.isSafeInteger(delta.configurationRevision)) {
+        httpConfigurationRevision = delta.configurationRevision
+      }
+      for (const message of delta.messages) {
+        httpHistoryMessageIds.add(message.id)
+        for (const frame of historyMessageToFrames(selectedSession, message, delta.toolCalls, { snapshot: true })) {
+          await emit(frame)
+        }
+      }
+    }
 
     function replayKey(params) {
       const update = params?.update
@@ -784,6 +807,22 @@ export class MonkeyAIRemoteService extends TypertRemoteService {
             data: event.params,
           })
         } else {
+          if (event.method === '_monkeyai/session/history_changed' && httpHistoryComplete && ticketHttpBase) {
+            // Large live message bodies are persisted instead of streamed as
+            // chunks. Match the desktop client: refresh the newest HTTP pages
+            // and merge the resulting message snapshots into the projection.
+            historyRefreshPromise = historyRefreshPromise.then(() => refreshPersistedHistory(
+              typeof event.params?.messageId === 'string' ? event.params.messageId : undefined,
+            )).catch(error => {
+              if (!signal.aborted) emit({
+                type: 'error',
+                sessionId: selectedSession,
+                code: 'history_refresh_failed',
+                message: error instanceof Error ? error.message : '刷新实时会话内容失败',
+              })
+            })
+            return
+          }
         if (withLoad && !loadCompleted) {
           const key = replayKey(event.params)
             if (key !== null) {
@@ -795,7 +834,7 @@ export class MonkeyAIRemoteService extends TypertRemoteService {
           }
           // Suppress replayed messages already delivered over HTTP, on every
           // connection generation (re-mounts replay the same window again).
-          if (withLoad) {
+          if (withLoad && event.params?._meta?.replay === true) {
             const replayMessageId = (typeof event.params?._meta?.messageId === 'string' && event.params._meta.messageId !== '')
               ? event.params._meta.messageId
               : (typeof event.params?.update?.messageId === 'string' ? event.params.update.messageId : '')
@@ -887,7 +926,22 @@ export class MonkeyAIRemoteService extends TypertRemoteService {
       const initialized = await acp.request('initialize', {
         protocolVersion: 1,
         clientInfo: ACP_CLIENT_INFO,
-        clientCapabilities: {},
+        // Match the MonkeyAI desktop client. historyHTTP opts this connection
+        // into HTTP-backed snapshots and history_changed notifications;
+        // session/load then mounts the live subscription without replaying the
+        // oversized history over ACP.
+        clientCapabilities: {
+          _meta: {
+            messageSnapshots: true,
+            interactionReplies: true,
+            historyHTTP: true,
+            queueHTTP: true,
+            historyRefresh: true,
+            configHTTP: true,
+            stateHTTP: true,
+            interactionHTTP: true,
+          },
+        },
       }, { signal })
       if (initialized?.agentCapabilities?.loadSession !== true) {
         throw new Error('MonkeyAI runtime does not advertise ACP session history loading')
@@ -898,14 +952,11 @@ export class MonkeyAIRemoteService extends TypertRemoteService {
         return
       }
       emit({ type: 'ready', sessionId: selectedSession })
-      if (httpHistoryComplete) {
-        // History came over HTTP; prompts and model switches work on a plain
-        // initialized connection. Skip session/load: its bounded replay
-        // always dies mid-stream and would churn reconnects for nothing.
-        loadCompleted = true
-        return
-      }
       try {
+        // With historyHTTP advertised this mounts the session for live
+        // notifications while leaving persisted history reads to the HTTP
+        // cursor API above. Older runtimes may still replay a bounded window;
+        // the message-id filter suppresses those duplicate snapshots.
         const loadResult = await acp.request('session/load', {
           sessionId: selectedSession,
           cwd,
@@ -914,6 +965,31 @@ export class MonkeyAIRemoteService extends TypertRemoteService {
         loadCompleted = true
         currentLoadedModel = typeof loadResult?._meta?.model === 'string' ? loadResult._meta.model : currentLoadedModel
         emitHistoryLoaded(currentLoadedModel)
+        // Close the gap between the initial full-history read and mounting the
+        // live subscription. A turn can start during that interval; snapshots
+        // replace any partial chunks that arrived before session/load resolved.
+        if (httpHistoryComplete) {
+          historyRefreshPromise = historyRefreshPromise.then(() => refreshPersistedHistory())
+          await historyRefreshPromise
+          // The desktop client tracks turn state via _monkeyai/session/state
+          // notifications. Seed the panel with the current status so a turn
+          // already running when the panel opens is shown as 进行中.
+          try {
+            const state = await readSessionState({ httpBase: ticketHttpBase, ticket: ticketValue, sessionId: selectedSession, signal })
+            const status = state?.state?.status
+            if (typeof status === 'string' && ['running', 'idle', 'error', 'interrupted'].includes(status)) {
+              emit({
+                type: 'notification',
+                sessionId: selectedSession,
+                method: '_monkeyai/session/state',
+                data: { sessionId: selectedSession, state: { status }, eventSeq: state.eventSeq },
+              })
+            }
+          } catch {
+            // Older runtimes may not expose the state read; live notifications
+            // still drive the status once the next turn starts.
+          }
+        }
       } catch (error) {
         if (signal?.aborted) throw error
         const message = error instanceof Error ? error.message : String(error)
@@ -958,6 +1034,7 @@ export class MonkeyAIRemoteService extends TypertRemoteService {
       const token = await this.refreshAccessToken(accountId, signal)
       const ticket = await this.requestConnectionTicket(accountId, grantRef, token, target, { signal })
       ticketValue = ticket.ticket
+      ticketHttpBase = ticket.httpBase
       if (signal.aborted) throw signal.reason ?? new Error('远程会话已取消')
 
       // Load the full history over the runtime's HTTP read channel before the
@@ -1302,6 +1379,34 @@ async function readSessionHistoryPage({ httpBase, ticket, sessionId, cursor, dir
   return result
 }
 
+async function readSessionState({ httpBase, ticket, sessionId, signal }) {
+  const timeout = AbortSignal.any([AbortSignal.timeout(15_000), ...(signal ? [signal] : [])])
+  const response = await fetch(`${httpBase.endsWith('/') ? httpBase : `${httpBase}/`}read/session`, {
+    method: 'POST',
+    headers: { authorization: `Bearer ${ticket}`, 'content-type': 'application/json' },
+    body: JSON.stringify({ method: '_monkeyai/session/state/get', params: { sessionId } }),
+    signal: timeout,
+  })
+  const text = await readHistoryBodyText(response).catch(error => {
+    if (response.ok) throw error
+    return ''
+  })
+  if (!response.ok) {
+    throw new Error(`MonkeyAI state read failed (${response.status}): ${text.slice(0, 200)}`)
+  }
+  let data
+  try {
+    data = JSON.parse(text)
+  } catch {
+    throw new Error('MonkeyAI state read returned invalid JSON')
+  }
+  const result = data?.result
+  if (!result || typeof result !== 'object' || !result.state || typeof result.state !== 'object') {
+    throw new Error('MonkeyAI state read returned an invalid response')
+  }
+  return result
+}
+
 function historyMessageText(parts) {
   return (Array.isArray(parts) ? parts : [])
     .filter(part => part?.type === 'text' && typeof part.text === 'string')
@@ -1312,7 +1417,7 @@ function historyMessageText(parts) {
 // Converts one history message snapshot into the same notification frame
 // shape the ACP replay produces, so the shared projection layer renders both
 // identically. Message ids match ACP replay messageIds (u-turn-N / a-turn-N).
-function historyMessageToFrames(sessionId, message, toolCallsById) {
+function historyMessageToFrames(sessionId, message, toolCallsById, { snapshot = false } = {}) {
   const frames = []
   const meta = { messageId: message.id, replay: true }
   const emitUpdate = update => {
@@ -1326,16 +1431,47 @@ function historyMessageToFrames(sessionId, message, toolCallsById) {
     const content = fileLinks.length > 0
       ? [...(text === '' ? [] : [{ type: 'text', text }]), ...fileLinks]
       : (text === '' ? undefined : { type: 'text', text })
-    if (content !== undefined) emitUpdate({ sessionUpdate: 'user_message_chunk', content })
+    if (content !== undefined) emitUpdate({ sessionUpdate: snapshot ? 'user_message' : 'user_message_chunk', content })
     return frames
   }
-  for (const part of Array.isArray(message.parts) ? message.parts : []) {
+  const parts = Array.isArray(message.parts) ? message.parts : []
+  const snapshotThought = snapshot
+    ? parts.filter(part => part?.type === 'thought' && typeof part.text === 'string').map(part => part.text).join('')
+    : ''
+  const snapshotText = snapshot
+    ? parts.filter(part => part?.type === 'text' && typeof part.text === 'string').map(part => part.text)
+      .concat(parts.filter(part => part?.type === 'error' && typeof part.reason === 'string').map(part => `[error] ${part.reason}`)).join('')
+    : ''
+  let snapshotThoughtEmitted = false
+  let snapshotTextEmitted = false
+  for (const part of parts) {
     if (part?.type === 'thought' && typeof part.text === 'string' && part.text !== '') {
-      emitUpdate({ sessionUpdate: 'agent_thought_chunk', content: { type: 'text', text: part.text } })
+      if (snapshot) {
+        if (!snapshotThoughtEmitted && snapshotThought !== '') {
+          emitUpdate({ sessionUpdate: 'agent_thought', content: { type: 'text', text: snapshotThought } })
+          snapshotThoughtEmitted = true
+        }
+      } else {
+        emitUpdate({ sessionUpdate: 'agent_thought_chunk', content: { type: 'text', text: part.text } })
+      }
     } else if (part?.type === 'text' && typeof part.text === 'string' && part.text !== '') {
-      emitUpdate({ sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: part.text } })
+      if (snapshot) {
+        if (!snapshotTextEmitted && snapshotText !== '') {
+          emitUpdate({ sessionUpdate: 'agent_message', content: { type: 'text', text: snapshotText } })
+          snapshotTextEmitted = true
+        }
+      } else {
+        emitUpdate({ sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: part.text } })
+      }
     } else if (part?.type === 'error' && typeof part.reason === 'string' && part.reason !== '') {
-      emitUpdate({ sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: `[error] ${part.reason}` } })
+      if (snapshot) {
+        if (!snapshotTextEmitted && snapshotText !== '') {
+          emitUpdate({ sessionUpdate: 'agent_message', content: { type: 'text', text: snapshotText } })
+          snapshotTextEmitted = true
+        }
+      } else {
+        emitUpdate({ sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: `[error] ${part.reason}` } })
+      }
     } else if (part?.type === 'file' && typeof part.uri === 'string') {
       emitUpdate({ sessionUpdate: 'agent_message_chunk', content: { type: 'resource_link', name: part.name, uri: part.uri } })
     } else if (part?.type === 'tool_call' && typeof part.toolCallId === 'string') {
@@ -1389,6 +1525,47 @@ async function fetchFullSessionHistory({ httpBase, ticket, sessionId, signal, on
   return { messageIds: [...seenIds], count: seenIds.size, configurationRevision }
 }
 
+// Refresh only the newest pages after a _monkeyai/session/history_changed
+// notification. Pages are oldest-to-newest internally and arrive newest-first;
+// stop once a known boundary is reached, retaining a changed message id even
+// when it was already present (the runtime may have replaced a partial body).
+async function fetchSessionHistoryDelta({ httpBase, ticket, sessionId, signal, knownMessageIds, changedMessageId, maxPages = 200 }) {
+  const pages = []
+  const seenIds = new Set()
+  const toolCalls = {}
+  let cursor
+  let configurationRevision
+  let foundBoundary = false
+  let foundChangedMessage = !changedMessageId
+  for (let page = 0; page < maxPages; page += 1) {
+    const timeout = AbortSignal.any([AbortSignal.timeout(30_000), ...(signal ? [signal] : [])])
+    const result = await readSessionHistoryPage({ httpBase, ticket, sessionId, cursor, direction: 'older', signal: timeout })
+    if (Number.isSafeInteger(result.session?.configurationRevision)) configurationRevision = result.session.configurationRevision
+    const pageMessages = []
+    for (const message of result.messages) {
+      if (typeof message?.id !== 'string' || message.id === '') continue
+      const known = knownMessageIds.has(message.id)
+      const changed = message.id === changedMessageId
+      if (changed) foundChangedMessage = true
+      if ((!known || changed) && !seenIds.has(message.id)) {
+        seenIds.add(message.id)
+        pageMessages.push(message)
+      }
+      if (known && !changed) foundBoundary = true
+    }
+    pages.push(pageMessages)
+    Object.assign(toolCalls, result.toolCalls ?? {})
+    if (foundBoundary && foundChangedMessage) break
+    cursor = typeof result.olderCursor === 'string' && result.olderCursor !== '' ? result.olderCursor : undefined
+    if (!cursor || result.messages.length === 0) break
+  }
+  return {
+    messages: pages.reverse().flat(),
+    toolCalls,
+    configurationRevision,
+  }
+}
+
 function validateResponse(method, params, result) {
   if (!isObject(result)) throw new TypeError('ACP response must be a JSON object')
   if (method === 'session/request_permission') {

package/src/shared/projection.mjs

@@ -14,6 +14,10 @@ export const TOOL_STATUS_LABEL = Object.freeze({
   pending: '排队中', in_progress: '执行中', completed: '完成', failed: '失败', cancelled: '已取消',
 })
 
+export const SESSION_STATUS_LABEL = Object.freeze({
+  running: '进行中', idle: '空闲', error: '出错', interrupted: '已中断',
+})
+
 function contentText(content) {
   const blocks = Array.isArray(content) ? content : content === undefined || content === null ? [] : [content]
   const parts = []
@@ -139,7 +143,15 @@ function projectFrames(frames) {
     if (frame.type === 'request') { continue } // rendered as an approval card from pendingRequests
     if (frame.type === 'model_switched') { entries.push({ kind: 'system', label: `已切换模型：${frame.data?.model ?? '所选模型'}`, key: `sys-model:${entries.length}` }); continue }
     if (frame.type === 'model_switch_failed') { continue } // surfaced via the error banner
-    if (frame.type === 'notification' && typeof frame.method === 'string' && frame.method.startsWith('_monkeyai/')) { continue } // internal runtime state notifications
+    if (frame.type === 'notification' && typeof frame.method === 'string' && frame.method.startsWith('_monkeyai/')) {
+      if (frame.method === '_monkeyai/session/state') {
+        const status = frame.data?.state?.status
+        if (typeof status === 'string' && SESSION_STATUS_LABEL[status]) {
+          entries.push({ kind: 'system', label: `会话状态：${SESSION_STATUS_LABEL[status]}`, key: `sys-state:${entries.length}` })
+        }
+      }
+      continue // internal runtime state notifications
+    }
     if (frame.type === 'error') { entries.push({ kind: 'raw', label: frame.code || 'error', data: { message: frame.message || frame.code }, key: `sys-err:${entries.length}` }); continue }
     entries.push({ kind: 'raw', label: frame.method || frame.type, data: frame.data, key: `raw:${frame.type}:${entries.length}` })
   }