dsh-plugin-mobile-gateway 0.10.4 → 0.11.0

package/docs/dsh-rc2-mobile-integration.md

@@ -1,6 +1,6 @@
-# DSH 0.1.5-rc.2 移动端接入
+# DSH 0.2.1-rc.2 移动端接入
 
-本次源码以 DSH 0.1.5-rc.2 为唯一 Host 基线，不提供旧 Host 分支。配对、设备 token、双连接和 `dsh-mobile-v1` 保持原样；以下是新的实时订阅和历史坐标约定。App 需要同步实现本说明，不能把独立流帧交给旧的 `SessionEvent.seq` reducer。
+本次源码以 DSH 0.2.1-rc.2 为唯一 Host 基线，不提供旧 Host 分支。配对、设备 token、双连接和 `dsh-mobile-v1` 保持原样；以下是新的实时订阅和历史坐标约定。App 需要同步实现本说明，不能把独立流帧交给旧的 `SessionEvent.seq` reducer。
 
 ## 1. 能力与历史缓存
 
@@ -10,13 +10,13 @@
 {
   "kind": "hello",
   "protocol": 3,
-  "dshVersion": "0.1.5-rc.2",
-  "historyFormatVersion": 3,
+  "dshVersion": "0.2.1-rc.2",
+  "historyFormatVersion": 4,
   "capabilities": ["assistant-stream-v1", "history-format-version", "projection-baseline"]
 }
 ```
 
-示例只列出新增字段和能力；原有能力仍在。`dshVersion` 是本适配器的目标版本声明，非运行时 CLI 版本探测。握手协议值 3 与 Session 格式值 3 是独立概念。
+示例只列出新增字段和能力；原有能力仍在。`dshVersion` 是本适配器的目标版本声明，非运行时 CLI 版本探测。握手协议值 3 与 Session 格式值 4 是独立概念。
 
 缓存键至少包含 `(gatewayId, sessionId, historyFormatVersion)`。缓存没有格式版本或与服务端不同，必须丢弃该 Session 的旧历史、分页游标、fork 锚点及临时输出，重新安装基线。DSH 自己迁移磁盘日志，客户端不得迁移旧 seq。
 
@@ -42,7 +42,7 @@
   "sessionId": "s1",
   "subscriptionId": "<UUID>",
   "streamId": "<本次上游 follow 的 UUID>",
-  "historyFormatVersion": 3,
+  "historyFormatVersion": 4,
   "cursor": 41,
   "replace": true,
   "view": "conversation",
@@ -124,16 +124,16 @@
 { "type": "history", "sessionId": "s1", "view": "conversation" }
 ```
 
-返回值新增 `historyFormatVersion: 3`、`cursor`。conversation 视图隐藏 `system/message`、`request/header`、`request/context`，移除 Assistant 事件中的 `data.stream`，保留真实 seq、最终 message、usage 和 interrupted。默认原始视图保留完整内嵌 stream，用于按需读取轨迹。全部为隐藏事件的页仍返回可前进的 nextBeforeSeq。
+返回值新增 `historyFormatVersion: 4`、`cursor`。conversation 视图隐藏 `system/message`、`request/header`、`request/context`，移除 Assistant 事件中的 `data.stream`，保留真实 seq、最终 message、usage 和 interrupted。默认原始视图保留完整内嵌 stream，用于按需读取轨迹。全部为隐藏事件的页仍返回可前进的 nextBeforeSeq。
 
 携带游标必须同时携带读取该游标时的格式版本：
 
 ```json
-{ "type": "history", "sessionId": "s1", "beforeSeq": 20, "historyFormatVersion": 3 }
-{ "type": "fork", "sessionId": "s1", "atSeq": 42, "historyFormatVersion": 3 }
+{ "type": "history", "sessionId": "s1", "beforeSeq": 20, "historyFormatVersion": 4 }
+{ "type": "fork", "sessionId": "s1", "atSeq": 42, "historyFormatVersion": 4 }
 ```
 
-缺失版本、旧版本或版本不匹配，返回 `code: "history-format-mismatch"`、`resetRequired: true` 和当前 historyFormatVersion，且不会调用上游分页/fork。客户端必须重建缓存后再取新坐标，不能给旧坐标补一个 3 后重试。游标必须是非负安全整数。省略 atSeq 的 fork 仍表示从最近完成轮次分叉。
+缺失版本、旧版本或版本不匹配，返回 `code: "history-format-mismatch"`、`resetRequired: true` 和当前 historyFormatVersion，且不会调用上游分页/fork。客户端必须重建缓存后再取新坐标，不能给旧坐标补一个 4 后重试。游标必须是非负安全整数。省略 atSeq 的 fork 仍表示从最近完成轮次分叉。
 
 收到 session-snapshot 后，不要用晚到的普通 history 响应覆盖正在进行的订阅基线；更早历史页只合并到历史部分。这样可以避免独立查询与实时流交错造成回滚。
 

package/lib/dsh-host-adapter.mjs

@@ -1,5 +1,6 @@
 import crypto from 'node:crypto'
 import os from 'node:os'
+import { sessionAddress } from './session-target.mjs'
 
 function requireRecord(value, endpoint) {
   if (value === null || typeof value !== 'object' || Array.isArray(value)) {
@@ -105,12 +106,13 @@ export function createDshHostAdapter(typertGateway, peer) {
       requestArgs(request),
       signal,
     ), 'session/follow')
-    return readSessionSnapshot(frame, request.address.sessionId)
+    return readSessionSnapshot(frame, request.address.kind === 'subagent'
+      ? request.address.childSessionId : request.address.sessionId)
   }
 
   const history = async (payload, signal) => {
     const request = {
-      address: { kind: 'session', sessionId: payload.sessionId },
+      address: sessionAddress(payload),
       // Older-page requests need only the opening cursor/projections, not another large latest page.
       ...(payload.beforeSeq !== undefined ? { maxMessages: 1 }
         : payload.maxMessages === undefined ? {} : { maxMessages: payload.maxMessages }),
@@ -216,10 +218,22 @@ export function createDshHostAdapter(typertGateway, peer) {
       transcribe: (request, signal) => invoke('speech', 'transcribe', { request }, signal),
     },
     sessions: {
+      projections: (payload, signal) => invoke('session', 'projections', requestArgs(payload), signal),
       list: (payload = {}, signal) => invoke('session', 'list', sessionListArgs(payload), signal),
       search: (payload, signal) => invoke('session', 'search', requestArgs(payload), signal),
       create: (payload, signal) => invoke('session', 'create', requestArgs(payload), signal),
       prompt: (payload, signal) => serializeSession(payload.sessionId, async () => {
+        if (payload.parentSessionId !== undefined) {
+          if (payload.subagentMode !== 'continuable') {
+            throw Object.assign(new Error('only continuable subagents accept messages'), { code: 'subagent/not-resumable' })
+          }
+          return invoke('subagents', 'prompt', requestArgs({
+            requestId: payload.requestId ?? crypto.randomUUID(),
+            parentSessionId: payload.parentSessionId, childSessionId: payload.sessionId,
+            mode: 'continuable', delivery: payload.mode, content: payload.content,
+            ...(payload.clientTimeZone === undefined ? {} : { clientTimeZone: payload.clientTimeZone }),
+          }), signal)
+        }
         // Accepted input may not have reached turn/start yet. Keep that gap
         // locked; the persistent event or a subsequent read retires the marker.
         const alreadyAdmitted = admittedPrompts.has(payload.sessionId)
@@ -233,7 +247,13 @@ export function createDshHostAdapter(typertGateway, peer) {
       }),
       attachment: (payload, signal) => invoke('session', 'attachment', requestArgs(payload), signal),
       fork: (payload, signal) => invoke('session', 'fork', requestArgs(payload), signal),
-      cancel: (payload, signal) => invoke('session', 'cancel', requestArgs(payload), signal),
+      cancel: (payload, signal) => payload.parentSessionId === undefined
+        ? invoke('session', 'cancel', requestArgs(payload), signal)
+        : payload.subagentMode !== 'continuable'
+          ? Promise.reject(Object.assign(new Error('only continuable subagents accept interrupts'), { code: 'subagent/not-resumable' }))
+          : invoke('subagents', 'interruptByParent', {
+            parentSessionId: payload.parentSessionId, childSessionId: payload.sessionId, mode: 'continuable',
+          }, signal),
       updateQueue: (payload, signal) => invoke('session', 'updateQueue', requestArgs(payload), signal),
       rename: (payload, signal) => invoke('session', 'rename', requestArgs(payload), signal),
       selectModel: (payload, signal) => invoke('session', 'selectModel', requestArgs(payload), signal),
@@ -377,10 +397,10 @@ export function createDshHostAdapter(typertGateway, peer) {
     observeSessionEvent(sessionId, event) {
       if (event.type === 'turn/start') admittedPrompts.delete(sessionId)
     },
-    openSessionStream(sessionId, signal) {
+    openSessionStream(sessionId, signal, target = { sessionId }) {
       return stream('session', 'follow',
         // Bound the opening window at the Host; older records remain available via session.page.
-        requestArgs({ address: { kind: 'session', sessionId }, maxMessages: 12, assistantStream: true }),
+        requestArgs({ address: sessionAddress(target), maxMessages: 12, assistantStream: true }),
         signal,
       )
     },

package/lib/index.mjs

@@ -139,6 +139,7 @@ import { createDshHostAdapter, DSH_VERSION, SESSION_FORMAT_VERSION } from './dsh
 import { createSpeechInputManager, SPEECH_REQUEST_TYPES } from './speech-input.mjs'
 import { handlePluginQuery, PLUGIN_REQUEST_TYPES } from './plugin-management.mjs'
 import { createSessionFollower } from './session-follower.mjs'
+import { parseSessionTarget, TEAM_PROJECTION_KINDS } from './session-target.mjs'
 import { createGatewayState, GATEWAY_MODES } from './gateway-state.mjs'
 import { createCloudflareTunnel } from './cloudflare-tunnel.mjs'
 import { gatewayProbeHeader } from './gateway-probe.mjs'
@@ -535,18 +536,26 @@ async function admitCommand(host, msg) {
 // Handle one mobile -> agent message through the official host API. Returns
 // the wire frame to send back, or null when nothing should be sent.
 async function admitMessage(api, msg) {
+  const target = parseSessionTarget(msg, { optional: true })
+  if (target.error) return target.error
+  const requestIdentity = typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}
+  const rejectMessage = frame => ({ ...frame, requestType: 'message', ...target.value, ...requestIdentity })
+  if (target.value.parentSessionId !== undefined && target.value.subagentMode !== 'continuable') {
+    return { kind: 'error', code: 'subagent/not-resumable', requestType: 'message', ...target.value,
+      ...requestIdentity, message: 'only continuable subagents accept messages' }
+  }
   const preset = parseAgentPreset(msg, 'message')
-  if (preset.error) return preset.error
+  if (preset.error) return rejectMessage(preset.error)
   if (preset.value !== undefined && typeof msg.sessionId === 'string' && msg.sessionId.trim()) {
-    return { kind: 'error', code: 'bad-request', requestType: 'message',
-      message: 'use select-agent-preset before sending a message to an existing session' }
+    return rejectMessage({ kind: 'error', code: 'bad-request',
+      message: 'use select-agent-preset before sending a message to an existing session' })
   }
   const text = typeof msg.text === 'string' ? msg.text.trim() : ''
   const parsedImages = parseWireImages(msg.images, 'message')
-  if (parsedImages.error) return parsedImages.error
+  if (parsedImages.error) return rejectMessage(parsedImages.error)
   const imageParts = parsedImages.value
   if (!text && imageParts.length === 0) {
-    return { kind: 'error', code: 'bad-request', message: 'message requires non-empty text or at least one image' }
+    return rejectMessage({ kind: 'error', code: 'bad-request', message: 'message requires non-empty text or at least one image' })
   }
   const mode = msg.mode === 'steer' ? 'steer' : 'queue'
 
@@ -570,8 +579,10 @@ async function admitMessage(api, msg) {
     }
 
     const resp = await api.sessions.prompt({
+      ...target.value,
       sessionId,
       mode,
+      ...(target.value.parentSessionId === undefined ? {} : requestIdentity),
       // Match the official WebUI ordering: images first, optional text last.
       content: [...imageParts, ...(text ? [{ type: 'text', text }] : [])],
       ...(typeof msg.clientTimeZone === 'string' && msg.clientTimeZone.trim() ? { clientTimeZone: msg.clientTimeZone.trim() } : {}),
@@ -581,13 +592,19 @@ async function admitMessage(api, msg) {
       kind: 'sent',
       sessionId,
       mode,
+      ...requestIdentity,
+      ...(target.value.parentSessionId === undefined ? {} : {
+        parentSessionId: target.value.parentSessionId, subagentMode: target.value.subagentMode,
+        messageId: resp.messageId,
+      }),
       ...(resp.command ? { command: resp.command } : {}),
     }
   } catch (error) {
     const code = error && error.code ? error.code : 'internal'
     const message = error && error.message ? error.message : String(error)
     log(`mobile message failed: ${message}`)
-    return { kind: 'error', code, message, ...(sessionId ? { sessionId } : {}) }
+    return { kind: 'error', code, message, requestType: 'message', ...target.value,
+      ...requestIdentity, ...(sessionId ? { sessionId } : {}) }
   }
 }
 
@@ -1080,13 +1097,13 @@ function requireGoalRef(msg, sessionId) {
   return { value: { id, revision } }
 }
 
-async function readSessionProjection(api, type, sessionId, key) {
-  const history = await proxyQuery(api, 'history', api.sessions.history.bind(api.sessions), { sessionId })
-  if (history.kind !== 'history') return history
+async function readSessionProjection(api, type, sessionId, key, target = { sessionId }) {
+  const history = await proxyQuery(api, 'history', api.sessions.history.bind(api.sessions), { ...target, maxMessages: 1 })
+  if (history.kind !== 'history') return { ...history, ...target, requestType: type }
   const values = (history.projections && history.projections.values) || {}
   return {
     kind: type,
-    sessionId,
+    ...target,
     asOfSeq: history.projections ? history.projections.asOfSeq : undefined,
     [key]: Object.prototype.hasOwnProperty.call(values, key) ? values[key] : null,
   }
@@ -1403,6 +1420,31 @@ function parseAgentPreset(msg, requestType, required = false) {
 // Dispatch one mobile query frame; returns the wire frame to send back.
 async function handleQuery(api, host, agentDefaultModel, msg, pluginContext) {
   if (PLUGIN_REQUEST_TYPES.has(msg.type)) return handlePluginQuery(api, msg, pluginContext)
+  if (msg.type === 'agent-team' || msg.type === 'subagents') {
+    const session = requireSessionId(msg)
+    const identity = typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}
+    if (session.error) return { ...session.error, ...identity }
+    const sessionId = session.value
+    const key = msg.type === 'agent-team' ? 'agentTeam' : 'subagentCatalog'
+    try {
+      const snapshot = await api.sessions.projections({ sessionId })
+      if (snapshot === null) throw Object.assign(new Error('session not found'), { code: 'session/not-found' })
+      if (!['sequenced', 'migration-required'].includes(snapshot?.kind)
+        || !snapshot.values || (snapshot.kind === 'sequenced' && !Number.isSafeInteger(snapshot.asOfSeq))) {
+        throw new Error('invalid session projections')
+      }
+      const value = snapshot.values[key] ?? null
+      if (value !== null && (key === 'subagentCatalog' ? !Array.isArray(value)
+        : !Array.isArray(value.members) || !Array.isArray(value.tasks))) throw new Error('invalid team projection')
+      return { kind: msg.type, sessionId, ...identity,
+        projectionState: snapshot.kind === 'migration-required' ? 'migration-required'
+          : value === null ? 'unavailable' : 'ready',
+        ...(snapshot.kind === 'sequenced' ? { asOfSeq: snapshot.asOfSeq } : {}), [key]: value }
+    } catch (error) {
+      return { kind: 'error', code: error.code || 'internal', message: error.message,
+        requestType: msg.type, sessionId, ...identity }
+    }
+  }
   if (msg.type === 'session-agent-preset' || msg.type === 'select-agent-preset') {
     const session = requireSessionId(msg)
     const preset = parseAgentPreset(msg, msg.type, msg.type === 'select-agent-preset')
@@ -1448,18 +1490,18 @@ async function handleQuery(api, host, agentDefaultModel, msg, pluginContext) {
     }) }
   }
   if (msg.type === 'history') {
-    const sessionId = typeof msg.sessionId === 'string' && msg.sessionId.trim() !== '' ? msg.sessionId.trim() : null
-    if (!sessionId) {
-      return { kind: 'error', code: 'bad-request', message: 'history requires a sessionId', requestType: 'history' }
-    }
+    const target = parseSessionTarget(msg)
+    if (target.error) return target.error
+    const { sessionId } = target.value
+    const identity = typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}
     const cursorError = validateHistoryCursor(msg, sessionId, 'beforeSeq')
-    if (cursorError) return cursorError
-    const payload = { sessionId }
+    if (cursorError) return { ...cursorError, ...target.value, ...identity }
+    const payload = { ...target.value }
     if (typeof msg.beforeSeq === 'number' && Number.isFinite(msg.beforeSeq)) payload.beforeSeq = msg.beforeSeq
     if (typeof msg.maxMessages === 'number' && Number.isFinite(msg.maxMessages)) payload.maxMessages = msg.maxMessages
     const frame = await proxyQuery(api, 'history', api.sessions.history.bind(api.sessions), payload)
-    if (frame.kind === 'history') return historyPage(frame, { ...msg, sessionId })
-    return frame
+    if (frame.kind === 'history') return { ...historyPage(frame, { ...msg, sessionId }), ...target.value, ...identity }
+    return { ...frame, ...target.value, ...identity }
   }
   if (msg.type === 'attachment') {
     const sessionId = requireSessionId(msg)
@@ -1527,16 +1569,17 @@ async function handleQuery(api, host, agentDefaultModel, msg, pluginContext) {
     return frame
   }
   if (msg.type === 'session-cancel') {
-    const sessionId = requireSessionId(msg)
-    if (sessionId.error) return sessionId.error
+    const target = parseSessionTarget(msg)
+    if (target.error) return target.error
+    const identity = typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}
     const frame = await proxyQuery(
       api,
       'session-cancel',
       api.sessions.cancel.bind(api.sessions),
-      { sessionId: sessionId.value },
+      target.value,
     )
-    if (frame.kind === 'error') return { ...frame, sessionId: sessionId.value }
-    return { ...frame, kind: 'session-cancelled', sessionId: sessionId.value }
+    if (frame.kind === 'error') return { ...frame, ...target.value, ...identity }
+    return { ...frame, kind: 'session-cancelled', ...target.value, ...identity }
   }
   if (msg.type === 'queue-update') {
     const sessionId = requireSessionId(msg)
@@ -1839,15 +1882,12 @@ async function handleQuery(api, host, agentDefaultModel, msg, pluginContext) {
       contextPressure: values.contextPressure || null,
     }
   }
-  if (msg.type === 'tasks') {
-    const sessionId = requireSessionId(msg)
-    if (sessionId.error) return sessionId.error
-    return readSessionProjection(api, 'tasks', sessionId.value, 'todos')
-  }
-  if (msg.type === 'goal') {
-    const sessionId = requireSessionId(msg)
-    if (sessionId.error) return sessionId.error
-    return readSessionProjection(api, 'goal', sessionId.value, 'goal')
+  if (msg.type === 'tasks' || msg.type === 'goal') {
+    const target = parseSessionTarget(msg)
+    if (target.error) return target.error
+    const frame = await readSessionProjection(api, msg.type, target.value.sessionId,
+      msg.type === 'tasks' ? 'todos' : 'goal', target.value)
+    return { ...frame, ...(typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}) }
   }
   if (msg.type === 'goal-edit') {
     const sessionId = requireSessionId(msg)
@@ -2996,6 +3036,8 @@ const plugin = {
               }
               void speechInput.handle(ws, msg, sendFrame).then(sendFrame)
             } else if (msg.type === 'subscribe') {
+              const target = parseSessionTarget(msg, { optional: true })
+              if (target.error) { sendFrame(target.error); return }
               if (msg.assistantStream !== undefined && typeof msg.assistantStream !== 'boolean') {
                 sendFrame({ kind: 'error', code: 'bad-request', requestType: 'subscribe', message: 'assistantStream must be a boolean' })
                 return
@@ -3009,9 +3051,9 @@ const plugin = {
               ws.filterSessionId = sessionId
               ws.sessionFollowerActive = msg.assistantStream === true
               const subscriptionId = crypto.randomUUID()
-              sendFrame({ kind: 'subscribed', sessionId: sessionId || null, subscriptionId, assistantStream: ws.sessionFollowerActive })
+              sendFrame({ kind: 'subscribed', ...target.value, sessionId: sessionId || null, subscriptionId, assistantStream: ws.sessionFollowerActive })
               if (ws.sessionFollowerActive) {
-                void ws.sessionFollower.start(sessionId, subscriptionId).catch(error => {
+                void ws.sessionFollower.start(sessionId, subscriptionId, target.value).catch(error => {
                   log(`session follower failed: ${error.message}`)
                   if (ws.readyState === 1) ws.close(1011, 'session follower failed')
                 })
@@ -3039,7 +3081,8 @@ const plugin = {
               admitMessage(api, msg).then((frame) => {
                 if (frame && ws.readyState === 1) ws.send(stringifyWireFrame(frame))
               })
-            } else if (msg.type === 'workspaces' || msg.type === 'sessions' || msg.type === 'history' || msg.type === 'attachment' ||
+            } else if (msg.type === 'agent-team' || msg.type === 'subagents' ||
+                       msg.type === 'workspaces' || msg.type === 'sessions' || msg.type === 'history' || msg.type === 'attachment' ||
                        msg.type === 'search' || msg.type === 'host' || msg.type === 'directories' || msg.type === 'directory-create' ||
                        msg.type === 'workspace-create' || msg.type === 'session-create' || msg.type === 'models' || msg.type === 'commands' || msg.type === 'command-execute' ||
                        msg.type === 'command-options' || msg.type === 'command-select' || msg.type === 'select-model' ||
@@ -3112,6 +3155,8 @@ const plugin = {
               'images',
               'session-create',
               'session-agent-preset',
+              'agent-team-v1',
+              'subagent-conversations-v1',
               'commands',
               'tasks',
               'goals',
@@ -3237,6 +3282,15 @@ const plugin = {
     const disposeScheduleChanged = ctx.on('schedule/changed', () => {
       if (clients.size > 0) broadcastSessionMetadataFrame({ kind: 'schedule-changed' })
     })
+    const disposeSessionStatus = ctx.on('api-session/status', (sessionId, running) => {
+      broadcastSessionMetadataFrame({ kind: 'session-status', sessionId: String(sessionId), running })
+    })
+    const disposeSessionAdded = ctx.on('api-session/added', summary => {
+      broadcastSessionMetadataFrame({ kind: 'session-status', sessionId: String(summary.sessionId), running: summary.running })
+    })
+    const disposeSessionRemoved = ctx.on('api-session/removed', sessionId => {
+      broadcastSessionMetadataFrame({ kind: 'session-status', sessionId: String(sessionId), running: false })
+    })
 
     const disposePluginsChanged = ctx.on('plugin-manager/changed', (change) => {
       if (clients.size > 0) broadcastSessionMetadataFrame({ kind: 'plugins-changed', reason: change?.reason })
@@ -3410,6 +3464,7 @@ const plugin = {
       todos: 'tasks-updated',
       goal: 'goal-updated',
       turnOutline: 'turn-outline-updated',
+      ...TEAM_PROJECTION_KINDS,
     }
     const projectionValues = (values = {}) => Object.fromEntries(
       Object.keys(projectionKinds).map(key => [key, values[key] ?? null]),
@@ -3419,7 +3474,8 @@ const plugin = {
       [key]: value,
     })
     const broadcastProjection = (sessionId, key, value, seq) => {
-      const broadcast = key === 'turnOutline' ? broadcastSessionMetadataFrame : broadcastInteractionFrame
+      const broadcast = key === 'turnOutline' || Object.hasOwn(TEAM_PROJECTION_KINDS, key)
+        ? broadcastSessionMetadataFrame : broadcastInteractionFrame
       broadcast(projectionFrame(sessionId, key, value, seq))
     }
 
@@ -3517,6 +3573,9 @@ const plugin = {
       disposeMgmt()
       disposeEvents()
       disposeScheduleChanged()
+      disposeSessionStatus()
+      disposeSessionAdded()
+      disposeSessionRemoved()
       disposePluginsChanged()
       disposePluginSettingsChanged()
       disposePluginInstallState()

package/lib/session-follower.mjs

@@ -91,7 +91,7 @@ export function createSessionFollower(api, { onFrame, onError, retryMs = 1000 })
     current = undefined
     previous?.abort.abort()
   }
-  const start = (sessionId, subscriptionId) => {
+  const start = (sessionId, subscriptionId, target = { sessionId }) => {
     stop()
     const state = { abort: new AbortController() }
     current = state
@@ -101,12 +101,12 @@ export function createSessionFollower(api, { onFrame, onError, retryMs = 1000 })
         const attemptAbort = new AbortController()
         const signal = AbortSignal.any([state.abort.signal, attemptAbort.signal])
         const streamId = crypto.randomUUID()
-        const context = { sessionId, subscriptionId, streamId }
+        const context = { ...target, sessionId, subscriptionId, streamId }
         const decode = createFollowDecoder(sessionId)
         let iterator
         let permanent = false
         try {
-          const stream = await api.openSessionStream(sessionId, signal)
+          const stream = await api.openSessionStream(sessionId, signal, target)
           iterator = stream[Symbol.asyncIterator]()
           while (current === state && !signal.aborted) {
             const item = await iterator.next()
@@ -117,7 +117,8 @@ export function createSessionFollower(api, { onFrame, onError, retryMs = 1000 })
           }
         } catch (error) {
           if (current !== state || signal.aborted) break
-          permanent = ['unsupported-session-format', 'session/not-found', 'gateway/bad-request'].includes(error.code)
+          permanent = ['unsupported-session-format', 'session/not-found', 'gateway/bad-request',
+            'subagent/unauthorized', 'subagent/not-found', 'subagent/catalog-diagnostic'].includes(error.code)
             || (error.code === 'SESSION_QUERY_PERSISTENCE_FAILED'
               && /refuses this format .*Session/.test(error.message || ''))
           onError(error, { ...context, retrying: !permanent })

package/lib/session-target.mjs

@@ -0,0 +1,29 @@
+// 移动端保留 sessionId 为当前视图 ID，父子关系只作为显式路由地址。
+export function parseSessionTarget(msg, { optional = false } = {}) {
+  const fail = message => ({ error: { kind: 'error', code: 'bad-request', requestType: msg.type, message,
+    ...(typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}) } })
+  const sessionId = typeof msg.sessionId === 'string' ? msg.sessionId.trim() : ''
+  const hasChildAddress = msg.parentSessionId !== undefined || msg.subagentMode !== undefined
+  if (!sessionId && (!optional || hasChildAddress)) return fail('sessionId must be a non-empty string')
+  if (!hasChildAddress) return { value: sessionId ? { sessionId } : {} }
+  const parentSessionId = typeof msg.parentSessionId === 'string' ? msg.parentSessionId.trim() : ''
+  if (!parentSessionId || parentSessionId === sessionId) return fail('parentSessionId must identify a different direct parent')
+  if (!['continuable', 'one-shot', 'unknown'].includes(msg.subagentMode)) {
+    return fail('subagentMode must be continuable, one-shot, or unknown')
+  }
+  return { value: { sessionId, parentSessionId, subagentMode: msg.subagentMode } }
+}
+
+export function sessionAddress(target) {
+  return target.parentSessionId === undefined
+    ? { kind: 'session', sessionId: target.sessionId }
+    : { kind: 'subagent', parentSessionId: target.parentSessionId,
+      childSessionId: target.sessionId, mode: target.subagentMode }
+}
+
+export const TEAM_PROJECTION_KINDS = {
+  agentTeam: 'agent-team-updated',
+  subagentCatalog: 'subagents-updated',
+  subagent: 'subagent-identity-updated',
+  subagentTiming: 'subagent-timing-updated',
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-mobile-gateway",
-  "version": "0.10.4",
-  "description": "DeepSeek Harness 移动网关，支持安全设备配对、实时会话同步、插件管理、官方语音输入、文件卡片与安全文件预览、局域网及 Cloudflare Tunnel，以及自适应深浅色控制面板。0.10.4 精简会话列表投影，仅保留标题与投影切点，修复大量会话通过公网隧道传输时超时的问题；保留会话元信息和历史完整投影，现有移动客户端无需配套修改。",
+  "version": "0.11.0",
+  "description": "DeepSeek Harness 移动网关，支持安全设备配对、实时会话同步、插件管理、官方语音输入、文件卡片与安全预览、局域网及 Cloudflare Tunnel。0.11.0 新增智能体团队与子会话协议，支持团队成员、共享任务看板、多层子智能体目录和运行状态实时同步，以及子智能体独立历史、视图切换、继续对话、图片输入与停止执行；提供完整 APP 接入文档，客户端需按能力发现接入。",
   "main": "lib/index.mjs",
   "files": [
     "bin",
@@ -26,7 +26,7 @@
   },
   "bin": "bin/setup-ip.mjs",
   "scripts": {
-    "test": "node test/wire-json.test.mjs && node test/setup-ip.test.mjs && node test/host-adapter.test.mjs && node test/speech-input.test.mjs && node test/plugin-management.test.mjs && node test/session-preset.test.mjs && node test/session-follower.test.mjs && node test/session-event-details.test.mjs && node test/gateway.test.mjs && node --test test/approval-replay.test.mjs && node test/auth.test.mjs && node test/lan.test.mjs && node test/cloudflared-binary.test.mjs && node test/cloudflare-tunnel.test.mjs && node --test test/public-endpoint-check.test.mjs && node test/gateway-tools.test.mjs && node test/multi-gateway.test.mjs"
+    "test": "node test/wire-json.test.mjs && node test/setup-ip.test.mjs && node test/host-adapter.test.mjs && node test/speech-input.test.mjs && node test/plugin-management.test.mjs && node test/session-preset.test.mjs && node test/session-follower.test.mjs && node --test test/agent-team.test.mjs && node test/session-event-details.test.mjs && node test/gateway.test.mjs && node --test test/approval-replay.test.mjs && node test/auth.test.mjs && node test/lan.test.mjs && node test/cloudflared-binary.test.mjs && node test/cloudflare-tunnel.test.mjs && node --test test/public-endpoint-check.test.mjs && node test/gateway-tools.test.mjs && node test/multi-gateway.test.mjs"
   },
   "exports": {
     ".": "./lib/index.mjs",