dsh-compact-relay 0.5.0 → 0.5.2

package/lib/adapters/http.js

@@ -6,9 +6,11 @@
 import { betterCompact, cancelBetterCompact, previewBetterCompact } from '../actions/better-compact.js';
 import { readCompactDiffs } from '../actions/compact-diff.js';
 import { readDiagnostics } from '../actions/diagnostics.js';
+import { forceArchiveSession } from '../actions/force-archive.js';
 import { handoff, previewHandoff } from '../actions/handoff.js';
 import { listHandoffDocs, readHandoffDoc } from '../actions/handoff-docs.js';
 import { recoverArchivedSession } from '../actions/recover.js';
+import { readCompactRelayChain } from '../actions/relay-chain.js';
 import { togglePin } from '../actions/pin.js';
 import { setNativeAutoCompactionEnabled } from '../actions/native-compaction.js';
 import { readState, resolveTarget } from '../actions/state.js';
@@ -183,6 +185,38 @@ export function registerHttp(webCtx, deps) {
   });
   webCtx.effect(() => stateStop, 'compact-relay: state endpoint');
 
+  // 0.5.1 DCR-05：完整交接链（一次读完，最多 8 层）。
+  //
+  // 旧客户端逐级 GET `/api/compact-relay-state?sessionId=父id`，宿主对未加载的祖先返回
+  // `sessionId:null` → 整条链只剩 1 层。这里改为服务端只读持久化日志（不加载会话），
+  // 把整条链一次返回；旧宿主没有 sessionPersistence 时返回 `ok:false`，客户端回落逐级读。
+  const chainStop = webCtx.webServer.register({
+    kind: 'exact',
+    path: '/api/compact-relay-chain',
+    handler: (req, res) => {
+      void (async () => {
+        try {
+          const rejection = hostRejection(webCtx, req);
+          if (rejection !== undefined) return denyAuth(res, rejection);
+          if (req.method !== 'GET') return send(res, 405, { ok: false, message: '只支持 GET' });
+          const url = new URL(req.url ?? '/', 'http://127.0.0.1');
+          const sessionId = url.searchParams.get('sessionId') ?? '';
+          if (typeof sessionId !== 'string' || sessionId.length === 0) {
+            return send(res, 400, { ok: false, message: '缺少 sessionId' });
+          }
+          send(res, 200, await readCompactRelayChain(deps, { sessionId }));
+        } catch (error) {
+          try {
+            send(res, 500, { ok: false, message: errorText(error) });
+          } catch {
+            /* 连接可能已断 */
+          }
+        }
+      })();
+    },
+  });
+  webCtx.effect(() => chainStop, 'compact-relay: relay chain endpoint');
+
   const streamStop = webCtx.webServer.register({
     kind: 'exact',
     path: '/api/compact-relay-stream',
@@ -383,6 +417,21 @@ export function registerHttp(webCtx, deps) {
           if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
             return send(res, 400, { ok: false, message: '请求体必须是 JSON 对象' });
           }
+          // 0.5.1 批 2：交接的归档开关 / 置顶确认只接受布尔值；类型错在动历史前就拒绝。
+          if (parsed.archive !== undefined && typeof parsed.archive !== 'boolean') {
+            return send(res, 400, { ok: false, message: 'archive 必须是 true/false（false = 只交接、不归档旧会话）' });
+          }
+          if (parsed.confirmUnpin !== undefined && typeof parsed.confirmUnpin !== 'boolean') {
+            return send(res, 400, { ok: false, message: 'confirmUnpin 必须是 true/false（true = 确认归档并取消旧会话置顶）' });
+          }
+          // 0.5.2 L 项：强制归档的破坏性动作只有用户点过二次确认才允许执行
+          // （confirmStop:true = 会停止旧会话上正在跑的 turn/subagent/job/schedule）。
+          if (parsed.confirmStop !== undefined && typeof parsed.confirmStop !== 'boolean') {
+            return send(res, 400, {
+              ok: false,
+              message: 'confirmStop 必须是 true/false（true = 确认停止旧会话上的任务后归档）',
+            });
+          }
           // 多数动作作用在具体会话上：缺 sessionId 或类型错时绝不能退化成「最后一个 agent」
           // （2026-10-19 debug：旧实现会压错会话）。
           // 例外：
@@ -391,8 +440,10 @@ export function registerHttp(webCtx, deps) {
           //     恒 400「缺少 sessionId」，于是「关闭自动压缩」永远写不进去、也看不到反馈。
           //   - recover 作用在**已归档**的旧会话上，它通常没有活 agent；不能走 resolveTarget
           //     （否则恒 409「没有活动会话」）。sessionId 由 recover 分支自己校验。
+          //   - force-archive 同样作用在**旧会话**（交接前的那个）上，通常没有活 agent 可解；
+          //     它自己的动作层会校验 sessionId 与 confirmStop，不走 resolveTarget。
           let agent = null;
-          if (parsed.action !== 'native-auto' && parsed.action !== 'recover') {
+          if (parsed.action !== 'native-auto' && parsed.action !== 'recover' && parsed.action !== 'force-archive') {
             if (typeof parsed.sessionId !== 'string' || parsed.sessionId.length === 0) {
               return send(res, 400, { ok: false, message: '缺少 sessionId' });
             }
@@ -409,6 +460,26 @@ export function registerHttp(webCtx, deps) {
             return send(res, 200, outcome);
           }
 
+          if (parsed.action === 'force-archive') {
+            // 0.5.2 L 项：用户确认「会停止旧会话上正在跑的任务」后强制归档（唯一 stopActivity 调用点）。
+            if (typeof parsed.sessionId !== 'string' || parsed.sessionId.length === 0) {
+              return send(res, 400, { ok: false, message: '缺少要强制归档的旧会话 sessionId' });
+            }
+            if (parsed.confirmStop !== true) {
+              return send(res, 400, {
+                ok: false,
+                code: 'force-archive',
+                message: '强制归档会停止旧会话上正在跑的任务，需要显式确认（confirmStop:true）',
+              });
+            }
+            const outcome = await forceArchiveSession(deps, {
+              sessionId: parsed.sessionId,
+              confirmStop: true,
+              confirmUnpin: parsed.confirmUnpin,
+            });
+            return send(res, 200, outcome);
+          }
+
           if (parsed.action === 'preview') {
             // M6：只算不写——先告诉用户「要压哪段、多少 token」，再让他确认。
             // A3：返回 planId，confirm 会带着它回来校验「同一段范围」。
@@ -462,12 +533,19 @@ export function registerHttp(webCtx, deps) {
           }
           if (parsed.action === 'handoff') {
             // 0.4 P2-1：`edits` 只允许「约束」「下一步」两段（多余的段/非法类型由 actions 拒绝）。
-            const outcome = await handoff(deps, { agent, edits: parsed.edits });
+            // 0.5.1 批 2：archive 缺省 true（0.5.0 行为）；confirmUnpin 只有用户确认「归档会取消置顶」时才传。
+            const outcome = await handoff(deps, {
+              agent,
+              edits: parsed.edits,
+              archive: parsed.archive,
+              confirmUnpin: parsed.confirmUnpin,
+            });
             return send(res, 200, {
               ok: true,
               message: outcome.message,
               childId: outcome.childId,
               path: outcome.path,
+              archive: outcome.archive,
             });
           }
           return send(res, 400, { ok: false, message: `未知动作：${String(parsed.action)}` });
@@ -494,6 +572,14 @@ export function registerHttp(webCtx, deps) {
             if (code === 'busy') {
               return send(res, 409, { ok: false, code, message: errorText(error) });
             }
+            // 0.5.2 L 项：强制归档失败要把**具体原因**带回界面（不静默、不吞成通用文案）。
+            if (code === 'force-archive') {
+              return send(res, 400, {
+                ok: false,
+                code,
+                message: error instanceof Error ? error.message : String(error),
+              });
+            }
             if (error?.statusCode === 413) {
               return send(res, 413, { ok: false, message: '请求体太大' });
             }