dsh-plugin-mobile-gateway 0.10.4 → 0.11.1

package/lib/index.mjs

@@ -21,7 +21,7 @@ import { assistantFinish, failureDetails, toolResultDetails, turnReasonDetails }
 //                     { "type": "subscribe", "sessionId": "..." }  (optional filter)
 //                     { "type": "unsubscribe" }
 //                     { "type": "message", "sessionId"?, "text"?, "images"?:
-//                       [{ "mediaType", "data", "name"? }], "mode"?: "queue"|"steer",
+//                       [{ "mediaType", "data", "name"? }], "files"?: [{ "receiptId" }], "mode"?: "queue"|"steer",
 //                       "workspaceId"?, "cwd"?, "clientTimeZone"? }
 //                        sessionId omitted -> a new session is created first; the
 //                        new session can be placed in a workspace via workspaceId
@@ -100,6 +100,10 @@ import { assistantFinish, failureDetails, toolResultDetails, turnReasonDetails }
 //                       "path", "name", "mediaType", "size", "chunkBytes" }
 //                     { "kind": "file-download-chunk", "transferId", "offset", "data", "eof", "sha256"? }
 //                     { "kind": "file-download-cancelled", "transferId" }
+//                     { "kind": "file-upload-opened", "requestId", "uploadId", "sessionId", "name", "size", "chunkBytes", "maxBytes", "idleTimeoutMs" }
+//                     { "kind": "file-upload-chunk-accepted", "requestId", "uploadId", "sessionId", "nextOffset" }
+//                     { "kind": "file-upload-completed", "requestId", "uploadId", "sessionId", "receiptId", "file", "sha256" }
+//                     { "kind": "file-upload-cancelled", "requestId", "uploadId", "sessionId" }
 //                     { "kind": "session-cancelled", "sessionId", "accepted": true }
 //                     { "kind": "queue-item-updated", "sessionId", "itemId", "action", "accepted": true }
 //                     { "kind": "session-queues", "queues": { "<sessionId>": [...] } }
@@ -137,8 +141,10 @@ import { WebSocketServer } from 'ws'
 import devicesModule from './devices.js'
 import { createDshHostAdapter, DSH_VERSION, SESSION_FORMAT_VERSION } from './dsh-host-adapter.mjs'
 import { createSpeechInputManager, SPEECH_REQUEST_TYPES } from './speech-input.mjs'
+import { createFileUploadManager, FILE_UPLOAD_REQUEST_TYPES, FILE_UPLOAD_DEFAULTS } from './file-upload.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'
@@ -226,6 +232,12 @@ const Config = Schema.object({
   fileDownloadChunkBytes: Schema.natural().min(64 * 1024).max(1024 * 1024).default(DEFAULT_FILE_DOWNLOAD_CHUNK_BYTES),
   fileDownloadIdleMs: Schema.natural().min(10_000).max(30 * 60 * 1000).default(DEFAULT_FILE_DOWNLOAD_IDLE_MS),
   fileDownloadMaxTransfers: Schema.natural().min(1).max(16).default(DEFAULT_FILE_DOWNLOAD_MAX_TRANSFERS),
+  fileUploadsEnabled: Schema.boolean().default(FILE_UPLOAD_DEFAULTS.fileUploadsEnabled),
+  fileUploadMaxBytes: Schema.natural().min(1024 * 1024).max(2 * 1024 * 1024 * 1024).default(FILE_UPLOAD_DEFAULTS.fileUploadMaxBytes),
+  fileUploadChunkBytes: Schema.natural().min(64 * 1024).max(1024 * 1024).default(FILE_UPLOAD_DEFAULTS.fileUploadChunkBytes),
+  fileUploadMaxTransfers: Schema.natural().min(1).max(16).default(FILE_UPLOAD_DEFAULTS.fileUploadMaxTransfers),
+  fileUploadIdleMs: Schema.natural().min(10_000).max(30 * 60 * 1000).default(FILE_UPLOAD_DEFAULTS.fileUploadIdleMs),
+  fileUploadCommitTimeoutMs: Schema.natural().min(10_000).max(30 * 60 * 1000).default(FILE_UPLOAD_DEFAULTS.fileUploadCommitTimeoutMs),
   adminLoopbackOnly: Schema.boolean().default(true),
   publicUrl: Schema.string().default(''),
   deviceFile: Schema.string().default(''),
@@ -277,6 +289,12 @@ function imagesOf(blocks) {
   return images
 }
 
+function filesOf(blocks) {
+  return blocks.filter(block => block?.type === 'file' && block.attachment).map(({ attachment }) => ({
+    attachmentId: attachment.attachmentId, name: attachment.name, bytes: attachment.bytes,
+  }))
+}
+
 // Build the small, owned JSON wire record for one session event. Reads only
 // leaf fields of the live SessionEvent — never serializes live objects.
 function buildWireEvent(session, event) {
@@ -288,6 +306,7 @@ function buildWireEvent(session, event) {
   switch (event.type) {
     case 'user/message': {
       const images = imagesOf(d.content || [])
+      const files = filesOf(d.content || [])
       return Object.assign(base, {
         event: {
           type: 'user/message',
@@ -295,6 +314,7 @@ function buildWireEvent(session, event) {
           source: d.source && d.source.kind,
           ...(typeof d.id === 'string' && d.id ? { raw: { id: d.id } } : {}),
           ...(images.length ? { images } : {}),
+          ...(files.length ? { files } : {}),
         },
       })
     }
@@ -535,18 +555,39 @@ 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' }
+  const files = msg.files === undefined ? [] : msg.files
+  if (!Array.isArray(files) || files.length > 20 || files.some(file => !file || typeof file.receiptId !== 'string'
+    || !file.receiptId.trim() || file.receiptId.length > 256)
+    || new Set(files.map(file => file.receiptId)).size !== files.length) {
+    return rejectMessage({ kind: 'error', code: 'bad-request', message: 'files must contain at most 20 distinct receiptId entries' })
+  }
+  if (files.length && (target.value.parentSessionId !== undefined || typeof msg.sessionId !== 'string' || !msg.sessionId.trim())) {
+    return rejectMessage({ kind: 'error', code: target.value.parentSessionId ? 'subagent/attachment-invalid' : 'bad-request',
+      message: 'file receipts require an existing ordinary session' })
+  }
+  if (files.length && (typeof msg.requestId !== 'string' || !msg.requestId.trim() || msg.requestId.length > 128)) {
+    return rejectMessage({ kind: 'error', code: 'bad-request', message: 'file messages require a requestId of 1..128 characters' })
+  }
+  if (!text && imageParts.length === 0 && files.length === 0) {
+    return rejectMessage({ kind: 'error', code: 'bad-request', message: 'message requires text, images or uploaded file receipts' })
   }
   const mode = msg.mode === 'steer' ? 'steer' : 'queue'
 
@@ -570,10 +611,13 @@ async function admitMessage(api, msg) {
     }
 
     const resp = await api.sessions.prompt({
+      ...target.value,
       sessionId,
       mode,
+      ...(target.value.parentSessionId === undefined && files.length === 0 ? {} : requestIdentity),
       // Match the official WebUI ordering: images first, optional text last.
-      content: [...imageParts, ...(text ? [{ type: 'text', text }] : [])],
+      content: [...imageParts, ...files.map(file => ({ type: 'file', receiptId: file.receiptId })),
+        ...(text ? [{ type: 'text', text }] : [])],
       ...(typeof msg.clientTimeZone === 'string' && msg.clientTimeZone.trim() ? { clientTimeZone: msg.clientTimeZone.trim() } : {}),
     })
     log(`mobile message accepted: session=${sessionId} mode=${mode} images=${imageParts.length} text="${text.slice(0, 60)}"`)
@@ -581,13 +625,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 +1130,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 +1453,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 +1523,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 +1602,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 +1915,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)
@@ -2217,7 +2290,7 @@ const plugin = {
     // 已配对设备沿用本机用户权限；身份只由 Host 创建，不能由移动端参数指定。
     // 问答与审批仍由本插件的 Host 监听器处理，无需另开 Remote 交互流。
     const peer = ctx.connection.createPeer({ principal: { kind: 'owner' }, interactions: 'none' })
-    const api = createDshHostAdapter(ctx.typertGateway, peer)
+    const api = createDshHostAdapter(ctx.typertGateway, peer, ctx.connection)
     const host = api
     const agentDefaultModel = ctx.agentDefaultModel
     const options = {
@@ -2234,6 +2307,7 @@ const plugin = {
       fileDownloadChunkBytes: DEFAULT_FILE_DOWNLOAD_CHUNK_BYTES,
       fileDownloadIdleMs: DEFAULT_FILE_DOWNLOAD_IDLE_MS,
       fileDownloadMaxTransfers: DEFAULT_FILE_DOWNLOAD_MAX_TRANSFERS,
+      ...FILE_UPLOAD_DEFAULTS,
       adminLoopbackOnly: true,
       publicUrl: '',
       deviceFile: '',
@@ -2291,12 +2365,14 @@ const plugin = {
     const pendingQuestions = new Map()
     const pendingApprovals = new Map()
     const fileTransfers = createFileTransferManager(api, options)
+    const fileUploads = createFileUploadManager(api, options)
     const speechInput = createSpeechInputManager(api, options)
     const fileTransferExpiryTimer = setInterval(() => {
       fileTransfers.expire().catch((error) => {
         log(`file download expiry failed: ${error && error.message ? error.message : String(error)}`)
       })
-    }, Math.min(options.fileDownloadIdleMs, 30_000))
+      fileUploads.expire().catch(error => log(`file upload expiry failed: ${error.message}`))
+    }, Math.min(options.fileDownloadIdleMs, options.fileUploadIdleMs, 30_000))
     const backgroundStreamAbort = new AbortController()
     let archivedSessionIds = null
     let sessionQueues = null
@@ -2981,12 +3057,20 @@ const plugin = {
             const conversationRequest = ['message', 'history', 'subscribe', 'unsubscribe'].includes(msg.type)
             if ((ws.mobileChannel === 'control' && conversationRequest) ||
                 (ws.mobileChannel === 'conversation' && !conversationRequest && msg.type !== 'ping')) {
-              ws.send(stringifyWireFrame({ kind: 'error', code: 'wrong-channel', requestType: msg.type, message: 'Request belongs to the other mobile channel' }))
+              ws.send(stringifyWireFrame({ kind: 'error', code: 'wrong-channel', requestType: msg.type,
+                ...(typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}), message: 'Request belongs to the other mobile channel' }))
               return
             }
 
             if (msg.type === 'ping') {
               ws.send(stringifyWireFrame({ kind: 'pong', at: Date.now() }))
+            } else if (FILE_UPLOAD_REQUEST_TYPES.has(msg.type)) {
+              if (!ws.deviceId) {
+                sendFrame({ kind: 'error', code: 'authentication-required', requestType: msg.type,
+                  ...(typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}), message: 'File uploads require a paired device' })
+                return
+              }
+              void fileUploads.handle(ws, msg).then(sendFrame)
             } else if (SPEECH_REQUEST_TYPES.has(msg.type)) {
               if (!ws.deviceId) {
                 sendFrame({ kind: 'error', code: 'authentication-required', requestType: msg.type,
@@ -2996,6 +3080,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 +3095,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')
                 })
@@ -3036,10 +3122,17 @@ const plugin = {
                 if (frame && ws.readyState === 1) ws.send(stringifyWireFrame(frame))
               })
             } else if (msg.type === 'message') {
+              if (Array.isArray(msg.files) && msg.files.length > 0 && (!ws.deviceId || !options.fileUploadsEnabled)) {
+                sendFrame({ kind: 'error', code: !ws.deviceId ? 'authentication-required' : 'file-upload-disabled',
+                  requestType: 'message', ...(typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}),
+                  message: 'File attachments require paired-device file upload access' })
+                return
+              }
               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' ||
@@ -3085,6 +3178,7 @@ const plugin = {
             fileTransfers.closeClient(ws).catch((error) => {
               log(`file download cleanup failed: ${error && error.message ? error.message : String(error)}`)
             })
+            fileUploads.closeClient(ws).catch(error => log(`file upload cleanup failed: ${error.message}`))
             log(`client disconnected (id=${id}, remaining=${clients.size})`)
           })
 
@@ -3112,12 +3206,15 @@ const plugin = {
               'images',
               'session-create',
               'session-agent-preset',
+              'agent-team-v1',
+              'subagent-conversations-v1',
               'commands',
               'tasks',
               'goals',
               'schedule-management',
               'plugin-management-v1',
               ...(device ? ['speech-input-v1'] : []),
+              ...(device && options.fileUploadsEnabled ? ['file-upload-v1'] : []),
               'session-cancel',
               'queue-control',
               'session-archive',
@@ -3237,6 +3334,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 +3516,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 +3526,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))
     }
 
@@ -3513,10 +3621,14 @@ const plugin = {
       fileTransfers.dispose().catch((error) => {
         log(`file download disposal failed: ${error && error.message ? error.message : String(error)}`)
       })
+      fileUploads.dispose().catch(error => log(`file upload disposal failed: ${error.message}`))
       disposeUpgrade()
       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.1",
+  "description": "DeepSeek Harness 移动网关，支持安全设备配对、实时会话同步、智能体团队与子会话、插件管理、官方语音输入，以及局域网和 Cloudflare Tunnel。0.11.1 新增普通文件分块上传，支持 SHA-256 校验、进度确认、取消与断线清理，复用 DSH 官方附件存储和会话专属凭证，支持文件随消息发送及实时和历史文件引用；提供详细 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 test/file-upload.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",