dsh-sessions-manager 3.7.1 → 3.7.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-sessions-manager",
   "description": "DSH 设置面板会话管理器：归档 / 恢复 / 彻底删除 / 移动到其他工作区，带工作区标签与会话日期；统一「会话管理」面板。Session manager for the DeepSeek Harness settings panel — archive / restore / permanently delete / move sessions across workspaces, with workspace tags & session dates in one unified panel.",
-  "version": "3.7.1",
+  "version": "3.7.3",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -58,14 +58,14 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-workspace": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-session-query": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-workspace": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-persistence-jsonl": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-query": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-storage-domain": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.6",
     "react": "^18.2.0"
   },
   "allowScripts": {

package/src/client/index.jsx

@@ -244,15 +244,58 @@ async function postJSON(path, body) {
 
 // 打开一个会话（尤其是侧栏不渲染的子代理会话）。
 //
-// 只走官方公开契约（runtime 的 client api-catalog）：
-//   sessions.open(id)                 —— 选中会话为当前
-//   sessions.refreshSubagents(parent) —— 刷新某父会话的直接子代理目录
-//   sessions.openSubagent(address)    —— 用「直接父 + 子」地址打开目录里的子代理
-// 拿不到 sessions 服务（老 runtime）时返回 false，由调用方给出降级提示，绝不
-// 触碰任何私有内部状态。
+// 只走官方公开契约，按方法存在性分支、不写死核心版本：
+//   旧核心（≤0.1.6）  ctx.get('sessions') 自带
+//     sessions.open(id)                 —— 选中会话为当前
+//     sessions.refreshSubagents(parent) —— 刷新某父会话的直接子代理目录
+//     sessions.openSubagent(address)    —— 用「直接父 + 子」地址打开目录里的子代理
+//   新核心（0.1.7+ / 0.2.0+）sessions 退化为会话数据流服务（retain/release/
+//     readPage…，没有 open），切换会话的公开入口是 uiWorkspace.openSession(target)：
+//     target 为会话 id 字符串，或 {parentSessionId, childSessionId, mode} 子代理
+//     地址（与旧 openSubagent 契约同形，replaceMain 经 sessions.retain 原生支持；
+//     id 命中已加载目录的子代理时核心会自动解析地址）。核心侧栏点会话走的就是
+//     这条路径（dsh-workspace-kit 0.1.12 起同样从 ctx.sessions.open 迁移过来）。
+// 拿不到任何服务时返回 null，由调用方给出降级提示，绝不触碰私有内部状态。
 let dsmClientCtx = null
 function dsmSessionsService() {
-  try { return dsmClientCtx && typeof dsmClientCtx.get === 'function' ? dsmClientCtx.get('sessions') : null } catch (e) { return null }
+  try {
+    if (!dsmClientCtx || typeof dsmClientCtx.get !== 'function') return null
+    const native = dsmClientCtx.get('sessions')
+    if (native && (typeof native.open === 'function' || typeof native.openSubagent === 'function')) return native
+    const ui = dsmClientCtx.get('uiWorkspace')
+    if (!ui || typeof ui.openSession !== 'function') return native
+    let lastOpened = null
+    const bridge = {
+      open(id) {
+        if (id === null || id === undefined) return
+        const target = String(id)
+        // 地址未加载的子代理会在这里被核心拒绝（unknown session），调用方
+        // 依赖抛错落回 openSubagent 地址路径，因此不吞异常。
+        ui.openSession(target)
+        lastOpened = target
+      },
+      openSubagent(address) {
+        if (address === null || address === undefined) return
+        if (typeof address === 'object') {
+          // 逐字段原样透传（parentSessionId / childSessionId / mode），新核心
+          // 的 retain 直接以该地址解析历史路由。
+          ui.openSession(address)
+          lastOpened = String(address.childSessionId)
+        } else {
+          bridge.open(address)
+        }
+      },
+      // 新核心的子代理目录由投影自动维护，无需手动刷新。
+      refreshSubagents() {},
+    }
+    // dsmCurrentSessionId 走 list.getSnapshot().current 校验切换结果；桥接下
+    // 核心未公开等价快照，以自己最近一次成功提交的目标为准。
+    Object.defineProperty(bridge, 'list', {
+      configurable: true,
+      get() { return { getSnapshot: () => ({ current: lastOpened }) } },
+    })
+    return bridge
+  } catch (e) { return null }
 }
 function dsmCurrentSessionId(svc) {
   try {

package/src/handle-era-ops.js

@@ -129,6 +129,37 @@ function failureText(e) {
   return `${(e && e.name) || ''} ${(e && e.message) || e}`
 }
 
+// 0.1.7 起官方把 Session 格式升到 v4，create() 严格要求 header.version ===
+// 后端当前版本（`encodeCurrent requires Session format vN`）。旧代（v2/v3）
+// 会话的 header 直接透传必炸。从该错误里解析后端声明的当前版本号。
+function requiredFormatVersionFromError(e) {
+  const m = /requires Session format v(\d+)/.exec(String((e && e.message) || ''))
+  return m ? Number(m[1]) : null
+}
+
+// 官方 v2→v4 一直接受的 header 字段。旧代 header 可能携带后续版本已移除的
+// 字段（如 seedLength），而 v4 起严格拒绝任何未知字段（"unexpected field"），
+// 重试前必须把 header 收敛到这个长期稳定集合。
+const OFFICIAL_HEADER_FIELDS = ['id', 'createdAt', 'cwd', 'isSeeded', 'delegationDepth', 'parentSession', 'origin', 'agentPreset']
+
+// 兼容性 create：先用调用方/采样得到的 header 直接建；若后端以「版本不符」
+// 拒绝，则把版本号提到后端声明的当前值、字段收敛到官方稳定集合后重试一次。
+// 只重试这一类错误：真正的词汇表/事件校验错误原样上抛，绝不静默降级。
+async function createWithCompatibleHeader(sp, header, createOptions) {
+  try {
+    return await sp.create(header, createOptions)
+  } catch (e) {
+    const required = requiredFormatVersionFromError(e)
+    if (required === null || header.version === required) throw e
+    const normalized = {}
+    for (const key of OFFICIAL_HEADER_FIELDS) {
+      if (Object.hasOwn(header, key)) normalized[key] = header[key]
+    }
+    normalized.version = required
+    return await sp.create(normalized, createOptions)
+  }
+}
+
 function isAlreadyOwned(e) {
   return /already owned/i.test(failureText(e))
 }
@@ -278,7 +309,20 @@ export async function moveSessionToCwd({ sp, sid, header, canonical, events = []
     error.code = 'DSM_SESSION_DUP_LOG'
     throw error
   }
-  const newHeader = Object.assign({}, header, { cwd: canonical })
+  const newHeaderBase = Object.assign({}, header, { cwd: canonical })
+  // 写所有权探测可能已为旧代会话发布了当前代；探测成功后再用官方 stat 重新
+  // 采样一次 header —— 后端自己编码的 header 天然携带当前格式版本与完整词汇表
+  // （0.1.7 的 create 严格要求 header.version === 后端当前版本）。stat 失败则
+  // 保留调用方 header，交给 createWithCompatibleHeader 的错误驱动重试兜底。
+  let createHeader = newHeaderBase
+  if (typeof sp.stat === 'function') {
+    try {
+      const fresh = await sp.stat(sid)
+      if (fresh && fresh.header && fresh.header.id === sid) {
+        createHeader = Object.assign({}, fresh.header, { cwd: canonical })
+      }
+    } catch (e) { /* 保持调用方 header */ }
+  }
   const firstSeq = events.length ? Number(events[0].seq) : 0
   const replay = firstSeq !== 0 ? events.map((event, index) => ({ ...event, seq: index })) : events
   const createOptions = header.isSeeded && Number.isSafeInteger(inheritedEventCount) && inheritedEventCount > 0
@@ -298,7 +342,7 @@ export async function moveSessionToCwd({ sp, sid, header, canonical, events = []
   let writer = null
   try {
     try {
-      writer = await sp.create(newHeader, createOptions)
+      writer = await createWithCompatibleHeader(sp, createHeader, createOptions)
       for (let i = 0; i < replay.length; i += MOVE_BATCH) {
         await writer.append(replay.slice(i, i + MOVE_BATCH))
       }