dsh-mobile-plugin 0.4.8 → 0.5.0

package/lib/mobile/stream.js

@@ -36,6 +36,7 @@ const { callSessions } = require('./rpc.js');
 const { unwrap } = require('./envelope.js');
 const { normalizeJobs } = require('./jobs.js');
 const { cutEvent, createToolNameIndex } = require('./wire-cut.js');
+const { noteLiveEvent, drainLiveSteps, liveStepsOf } = require('./live-steps.js');
 const approvals = require('./approvals.js');
 const questions = require('./questions.js');
 const streamRegistry = require('./stream-registry.js');
@@ -475,6 +476,18 @@ async function handleStream(ctx, req, res) {
   const imageBudget = createTextImageBudget();
   // 过程明细的减法（wire-cut.js）与它要的工具名索引：整条流共用一份，回放与实时帧都往里吸。
   const toolNames = createToolNameIndex();
+  /**
+   * 跑着那一轮的过程清单一发（`session/live-steps`）。
+   *
+   * `full: true` = 「到此刻为止跑过哪几步」的全量快照（开流那一刻补发：中途进一条正在跑的
+   * 会话、断线重连都靠它）；`full: false` = 一次增量（新的一步，或某一步的状态变了），App
+   * 按 `key` 替换。**不带 seq**：它不是会话事件，不参与序门与水位（口径同 `session/queue`）。
+   * 一行摘要由电脑算好 —— 推理全文与工具参数都不上线路（见 wire-cut.js）。
+   */
+  const writeLiveSteps = (steps, full, frameArg) => {
+    if (!Array.isArray(steps)) return;
+    writeSse(res, { type: 'session/live-steps', sessionId, full, steps }, frameArg, { sealFrame });
+  };
 
   try {
     // **先开实时流、再回放**：之前是先 replay 再 mux，两步之间的 follow 还没订阅，
@@ -498,6 +511,12 @@ async function handleStream(ctx, req, res) {
       }
     }
 
+    // 开流先补一份过程清单：这条流从此刻起只发「变化的那几步」，之前跑过的那些靠这份快照
+    // 铺出来（中途进会话 / 重连都走这里）。**一步都没有时就一个字都不发** —— 空快照只在
+    // 告诉手机「你手上那份作废」，而那种情况由新的一轮开始时清（App 侧 `resetLiveSteps`）。
+    const opening = liveStepsOf(ctx, sessionId);
+    if (!clientGone && opening.length > 0) writeLiveSteps(opening, true, null);
+
     if (!clientGone) {
       // 写一帧并把三种结果统一收口：丢增量、需要等 drain、该收尾。
       // 「需要等 drain」这一步是这次 OOM 的正解 —— 写不动就停手，等底层消化完再继续，
@@ -535,6 +554,16 @@ async function handleStream(ctx, req, res) {
           // 预算按**整条流**共享：本机路径的图片内联（local-images.js）此前是每帧一份，
           // 一条消息里几张截图就能把几百 KB 到几 MB 的 base64 推进去。
           let event = await resolveEventAttachments(ctx, sessionId, p.event, { referencesOnly: true, budget: imageBudget });
+          // 过程副本：推理正文与工具参数不上线路，但用户点开「正在读取文件」那一步时要
+          // 就地答得出来（落盘之前宿主的历史里还没有这一份，见 live-steps.js）。
+          noteLiveEvent(ctx, sessionId, event);
+          // 过程清单的增量：这一步刚开、或某一步的状态变了，把变化的那几行发出去。
+          // 排在事件本身之前发顺序不影响判断（清单是「到此刻为止」的旁白，不是内容）。
+          for (const changed of drainLiveSteps(ctx, sessionId)) {
+            const value = { type: 'session/live-steps', sessionId, full: false, steps: [changed] };
+            if (await pushOrdered(value, null) === 'closed') { clientGone = true; break; }
+          }
+          if (clientGone) break;
           // 先吸工具名再减：结果自己不带工具名，正文留不留取决于它（见 wire-cut.js）。
           toolNames.absorb(event);
           event = cutEvent(event, toolNames);