dsh-mobile-web 0.1.1 → 0.1.3

package/src/host/rpc/index.js

@@ -1,32 +1,32 @@
-/**
- * RPC 注册表：方法名 → handler。
- *
- * 迁移期与 `core.js` 里的 switch **并存**：注册表优先命中，未命中的继续走 switch。
- * 这样每搬一个域，方法集合与方法语义都保持逐字不变（可拿
- * `.dsh-scratch/rpc-diff.mjs` 把「switch case ∪ 注册表键」和基线方法表比一遍）。
- *
- * handler 签名统一为 `(payload, bag) => Promise<Result>`：
- *   · `payload` = RPC 的 payload
- *   · `bag`     = 每请求上下文（当前只有 `{ deviceId }`）
- *   · 返回      = `{ ok: true, value }` 或 `{ ok: false, error: { code, message, ... } }`
- *
- * 这里**不捕获异常**：抛错仍由 `handleRpc` 原有的 try/catch 包成错误信封，
- * 免得迁移顺带改掉错误码语义。
- */
-export function createRpcRegistry({ domains = [] } = {}) {
-  const table = new Map()
-  for (const domain of domains) {
-    if (!domain || typeof domain !== 'object') throw new Error('RPC 域必须是对象字面量')
-    for (const [method, handler] of Object.entries(domain)) {
-      if (typeof handler !== 'function') throw new Error(`RPC handler 不是函数：${method}`)
-      if (table.has(method)) throw new Error(`重复注册的 RPC 方法：${method}`)
-      table.set(method, handler)
-    }
-  }
-  return {
-    get: (method) => table.get(method),
-    has: (method) => table.has(method),
-    names: () => [...table.keys()].sort(),
-    size: () => table.size,
-  }
-}
+/**
+ * RPC 注册表：方法名 → handler。
+ *
+ * 迁移期与 `core.js` 里的 switch **并存**：注册表优先命中，未命中的继续走 switch。
+ * 这样每搬一个域，方法集合与方法语义都保持逐字不变（可拿
+ * `.dsh-scratch/rpc-diff.mjs` 把「switch case ∪ 注册表键」和基线方法表比一遍）。
+ *
+ * handler 签名统一为 `(payload, bag) => Promise<Result>`：
+ *   · `payload` = RPC 的 payload
+ *   · `bag`     = 每请求上下文（当前只有 `{ deviceId }`）
+ *   · 返回      = `{ ok: true, value }` 或 `{ ok: false, error: { code, message, ... } }`
+ *
+ * 这里**不捕获异常**：抛错仍由 `handleRpc` 原有的 try/catch 包成错误信封，
+ * 免得迁移顺带改掉错误码语义。
+ */
+export function createRpcRegistry({ domains = [] } = {}) {
+  const table = new Map()
+  for (const domain of domains) {
+    if (!domain || typeof domain !== 'object') throw new Error('RPC 域必须是对象字面量')
+    for (const [method, handler] of Object.entries(domain)) {
+      if (typeof handler !== 'function') throw new Error(`RPC handler 不是函数：${method}`)
+      if (table.has(method)) throw new Error(`重复注册的 RPC 方法：${method}`)
+      table.set(method, handler)
+    }
+  }
+  return {
+    get: (method) => table.get(method),
+    has: (method) => table.has(method),
+    names: () => [...table.keys()].sort(),
+    size: () => table.size,
+  }
+}

package/src/host/rpc/push.js

@@ -1,58 +1,58 @@
-/**
- * push.* 域（3 个方法）：通知配置的读写 + 订阅开关（订阅目前是空实现，保留是为了
- * 让 bundle 的调用不报 not-supported）。
- *
- * 从 `core.js` 搬出。`notifyConfig` 是 core 里的可变状态（`let`），所以这里不拿值，
- * 走 `getNotifyConfig()` / `setNotifyConfig()` 访问器；其余依赖都由 core 注入。
- */
-export function createPushRpc({ getNotifyConfig, setNotifyConfig, deliverNotify, notifyChannelsView, saveNotifyConfig }) {
-  return {
-    'push.config': (payload) => {
-      const body = payload || {}
-      if (body.test === true) {
-        deliverNotify(getNotifyConfig(), { title: 'dsh 掌上 · 测试通知', body: '收到这条说明推送通道工作正常。' }).catch(() => {})
-        return { ok: true, value: { sent: true } }
-      }
-      if (body.get === true) {
-        const c = getNotifyConfig()
-        return {
-          ok: true,
-          value: {
-            turnThresholdMs: c.turnThresholdMs,
-            turnCooldownMs: c.turnCooldownMs,
-            hideDetails: c.hideDetails === true,
-            kinds: {
-              jobs: !!(c.kinds && c.kinds.jobs === true),
-              todo: !(c.kinds && c.kinds.todo === false),
-              turns: !!(c.kinds && c.kinds.turns === true),
-            },
-            vapidPublicKey: '',
-            channels: notifyChannelsView(c.channels),
-          },
-        }
-      }
-      const patch = body.set
-      if (!patch || typeof patch !== 'object') {
-        return { ok: false, error: { code: 'bad-request', message: '缺少配置内容' } }
-      }
-      const current = getNotifyConfig()
-      const next = { ...current }
-      if (typeof patch.turnThresholdMs === 'number' && Number.isFinite(patch.turnThresholdMs)) next.turnThresholdMs = Math.max(0, Math.round(patch.turnThresholdMs))
-      if (typeof patch.turnCooldownMs === 'number' && Number.isFinite(patch.turnCooldownMs)) next.turnCooldownMs = Math.max(0, Math.round(patch.turnCooldownMs))
-      if (typeof patch.hideDetails === 'boolean') next.hideDetails = patch.hideDetails
-      if (patch.kinds && typeof patch.kinds === 'object') next.kinds = { ...(current.kinds || {}), ...patch.kinds }
-      if (patch.channels && typeof patch.channels === 'object') {
-        const merged = { ...(current.channels || {}) }
-        for (const [k, v] of Object.entries(patch.channels)) {
-          if (v && typeof v === 'object') merged[k] = { ...(merged[k] || {}), ...v }
-        }
-        next.channels = merged
-      }
-      setNotifyConfig(next)
-      saveNotifyConfig(next)
-      return { ok: true, value: { stored: true } }
-    },
-    'push.subscribe': async () => ({ ok: true, value: { ok: true } }),
-    'push.unsubscribe': async () => ({ ok: true, value: { ok: true } }),
-  }
-}
+/**
+ * push.* 域（3 个方法）：通知配置的读写 + 订阅开关（订阅目前是空实现，保留是为了
+ * 让 bundle 的调用不报 not-supported）。
+ *
+ * 从 `core.js` 搬出。`notifyConfig` 是 core 里的可变状态（`let`），所以这里不拿值，
+ * 走 `getNotifyConfig()` / `setNotifyConfig()` 访问器；其余依赖都由 core 注入。
+ */
+export function createPushRpc({ getNotifyConfig, setNotifyConfig, deliverNotify, notifyChannelsView, saveNotifyConfig }) {
+  return {
+    'push.config': (payload) => {
+      const body = payload || {}
+      if (body.test === true) {
+        deliverNotify(getNotifyConfig(), { title: 'dsh 掌上 · 测试通知', body: '收到这条说明推送通道工作正常。' }).catch(() => {})
+        return { ok: true, value: { sent: true } }
+      }
+      if (body.get === true) {
+        const c = getNotifyConfig()
+        return {
+          ok: true,
+          value: {
+            turnThresholdMs: c.turnThresholdMs,
+            turnCooldownMs: c.turnCooldownMs,
+            hideDetails: c.hideDetails === true,
+            kinds: {
+              jobs: !!(c.kinds && c.kinds.jobs === true),
+              todo: !(c.kinds && c.kinds.todo === false),
+              turns: !!(c.kinds && c.kinds.turns === true),
+            },
+            vapidPublicKey: '',
+            channels: notifyChannelsView(c.channels),
+          },
+        }
+      }
+      const patch = body.set
+      if (!patch || typeof patch !== 'object') {
+        return { ok: false, error: { code: 'bad-request', message: '缺少配置内容' } }
+      }
+      const current = getNotifyConfig()
+      const next = { ...current }
+      if (typeof patch.turnThresholdMs === 'number' && Number.isFinite(patch.turnThresholdMs)) next.turnThresholdMs = Math.max(0, Math.round(patch.turnThresholdMs))
+      if (typeof patch.turnCooldownMs === 'number' && Number.isFinite(patch.turnCooldownMs)) next.turnCooldownMs = Math.max(0, Math.round(patch.turnCooldownMs))
+      if (typeof patch.hideDetails === 'boolean') next.hideDetails = patch.hideDetails
+      if (patch.kinds && typeof patch.kinds === 'object') next.kinds = { ...(current.kinds || {}), ...patch.kinds }
+      if (patch.channels && typeof patch.channels === 'object') {
+        const merged = { ...(current.channels || {}) }
+        for (const [k, v] of Object.entries(patch.channels)) {
+          if (v && typeof v === 'object') merged[k] = { ...(merged[k] || {}), ...v }
+        }
+        next.channels = merged
+      }
+      setNotifyConfig(next)
+      saveNotifyConfig(next)
+      return { ok: true, value: { stored: true } }
+    },
+    'push.subscribe': async () => ({ ok: true, value: { ok: true } }),
+    'push.unsubscribe': async () => ({ ok: true, value: { ok: true } }),
+  }
+}

package/src/host/rpc/settings.js

@@ -1,88 +1,88 @@
-/**
- * settings.* 域（3 个方法）：宿主设置页的只读视图 + 手机端唯一可写的「外观偏好」。
- *
- * 从 `core.js` 的 switch 原样搬出。依赖由 `core.js` 一次性注入：
- *   · `getService(name)` —— 取宿主服务（这里是 `settings`）
- *   · `devices`          —— 设备表（外观偏好按设备存）
- *   · `persistDevices()` —— 落盘设备表
- * handler 的第二个参数 `bag` 是每请求上下文，这里只用到 `bag.deviceId`。
- */
-export function createSettingsRpc({ getService, devices, persistDevices }) {
-  /**
-   * settings.read / settings.describe 共用：返回 namespaces 列表，
-   * 并把**本设备**自己选的外观偏好回填进 ui-theme。
-   */
-  function readSettings(payload, bag) {
-    const settings = getService('settings')
-    if (!settings || typeof settings.describe !== 'function') {
-      return { ok: true, value: { writable: false, hasDocument: false, namespaces: [] } }
-    }
-    let list
-    try {
-      list = settings.describe({ redactSecrets: true })
-    } catch {
-      list = []
-    }
-    const namespaces = (Array.isArray(list) ? list : []).map((d) => ({
-      ns: d.ns,
-      schema: d.schema,
-      value: d.value,
-      ...(d.base !== undefined ? { base: d.base } : {}),
-      ...(d.user !== undefined ? { user: d.user } : {}),
-      applies: d.applies || 'live',
-      secrets: Array.isArray(d.secrets) ? d.secrets : [],
-      revision: d.revision,
-    }))
-    // 外观偏好按设备独立：bundle 每次启动都会读 ui-theme.preference 并应用
-    // （Fr(value)），如果不覆盖，它就会用宿主那份跨端同步值把手机上刚设的
-    // 深色顶掉 —— 表现就是「设成深色，刷新又变浅色」。
-    // 这里把该设备自己的选择回填进去，手机之间/桌面端互不影响。
-    const settingsDevice = bag && typeof bag.deviceId === 'string'
-      ? devices.get(bag.deviceId)
-      : undefined
-    const deviceTheme = settingsDevice && typeof settingsDevice.theme === 'string' ? settingsDevice.theme : ''
-    if (deviceTheme === 'dark' || deviceTheme === 'light' || deviceTheme === 'system') {
-      for (const entry of namespaces) {
-        if (entry.ns !== 'ui-theme') continue
-        const value = entry.value && typeof entry.value === 'object' ? { ...entry.value } : {}
-        value.preference = deviceTheme
-        entry.value = value
-      }
-    }
-    return { ok: true, value: { writable: false, hasDocument: false, namespaces } }
-  }
-
-  return {
-    'settings.read': readSettings,
-    'settings.describe': readSettings,
-    'settings.mutate': (payload, bag) => {
-      // 手机端只开放「外观偏好」这一项，而且是**按设备**存：
-      //   · 写宿主 ui-theme 是跨端同步设置，手机上换深色会把桌面 GUI 一起改掉；
-      //   · 用户预期是「手机自己的主题跟着手机走」，所以存进设备表，
-      //     启动时再由上面的 settings.read 回填给 bundle。
-      const targetId = bag && typeof bag.deviceId === 'string' ? bag.deviceId : ''
-      const target = devices.get(targetId)
-      if (!target) return { ok: false, error: { code: 'unpaired', message: '设备未配对' } }
-      const ns = typeof payload?.ns === 'string' ? payload.ns : ''
-      if (ns !== 'ui-theme') {
-        return { ok: false, error: { code: 'forbidden', message: '该设置项不允许在手机端修改' } }
-      }
-      const ops = Array.isArray(payload?.ops) ? payload.ops : []
-      let nextTheme = ''
-      for (const op of ops) {
-        if (!op || op.op !== 'set' || !Array.isArray(op.path) || op.path.length !== 1 || op.path[0] !== 'preference') {
-          return { ok: false, error: { code: 'bad-request', message: '只支持设置外观偏好' } }
-        }
-        if (op.value !== 'dark' && op.value !== 'light' && op.value !== 'system') {
-          return { ok: false, error: { code: 'bad-request', message: '外观偏好只能是 dark / light / system' } }
-        }
-        nextTheme = op.value
-      }
-      if (nextTheme !== '' && target.theme !== nextTheme) {
-        target.theme = nextTheme
-        persistDevices()
-      }
-      return { ok: true, value: { ok: true } }
-    },
-  }
-}
+/**
+ * settings.* 域（3 个方法）：宿主设置页的只读视图 + 手机端唯一可写的「外观偏好」。
+ *
+ * 从 `core.js` 的 switch 原样搬出。依赖由 `core.js` 一次性注入：
+ *   · `getService(name)` —— 取宿主服务（这里是 `settings`）
+ *   · `devices`          —— 设备表（外观偏好按设备存）
+ *   · `persistDevices()` —— 落盘设备表
+ * handler 的第二个参数 `bag` 是每请求上下文，这里只用到 `bag.deviceId`。
+ */
+export function createSettingsRpc({ getService, devices, persistDevices }) {
+  /**
+   * settings.read / settings.describe 共用：返回 namespaces 列表，
+   * 并把**本设备**自己选的外观偏好回填进 ui-theme。
+   */
+  function readSettings(payload, bag) {
+    const settings = getService('settings')
+    if (!settings || typeof settings.describe !== 'function') {
+      return { ok: true, value: { writable: false, hasDocument: false, namespaces: [] } }
+    }
+    let list
+    try {
+      list = settings.describe({ redactSecrets: true })
+    } catch {
+      list = []
+    }
+    const namespaces = (Array.isArray(list) ? list : []).map((d) => ({
+      ns: d.ns,
+      schema: d.schema,
+      value: d.value,
+      ...(d.base !== undefined ? { base: d.base } : {}),
+      ...(d.user !== undefined ? { user: d.user } : {}),
+      applies: d.applies || 'live',
+      secrets: Array.isArray(d.secrets) ? d.secrets : [],
+      revision: d.revision,
+    }))
+    // 外观偏好按设备独立：bundle 每次启动都会读 ui-theme.preference 并应用
+    // （Fr(value)），如果不覆盖，它就会用宿主那份跨端同步值把手机上刚设的
+    // 深色顶掉 —— 表现就是「设成深色，刷新又变浅色」。
+    // 这里把该设备自己的选择回填进去，手机之间/桌面端互不影响。
+    const settingsDevice = bag && typeof bag.deviceId === 'string'
+      ? devices.get(bag.deviceId)
+      : undefined
+    const deviceTheme = settingsDevice && typeof settingsDevice.theme === 'string' ? settingsDevice.theme : ''
+    if (deviceTheme === 'dark' || deviceTheme === 'light' || deviceTheme === 'system') {
+      for (const entry of namespaces) {
+        if (entry.ns !== 'ui-theme') continue
+        const value = entry.value && typeof entry.value === 'object' ? { ...entry.value } : {}
+        value.preference = deviceTheme
+        entry.value = value
+      }
+    }
+    return { ok: true, value: { writable: false, hasDocument: false, namespaces } }
+  }
+
+  return {
+    'settings.read': readSettings,
+    'settings.describe': readSettings,
+    'settings.mutate': (payload, bag) => {
+      // 手机端只开放「外观偏好」这一项，而且是**按设备**存：
+      //   · 写宿主 ui-theme 是跨端同步设置，手机上换深色会把桌面 GUI 一起改掉；
+      //   · 用户预期是「手机自己的主题跟着手机走」，所以存进设备表，
+      //     启动时再由上面的 settings.read 回填给 bundle。
+      const targetId = bag && typeof bag.deviceId === 'string' ? bag.deviceId : ''
+      const target = devices.get(targetId)
+      if (!target) return { ok: false, error: { code: 'unpaired', message: '设备未配对' } }
+      const ns = typeof payload?.ns === 'string' ? payload.ns : ''
+      if (ns !== 'ui-theme') {
+        return { ok: false, error: { code: 'forbidden', message: '该设置项不允许在手机端修改' } }
+      }
+      const ops = Array.isArray(payload?.ops) ? payload.ops : []
+      let nextTheme = ''
+      for (const op of ops) {
+        if (!op || op.op !== 'set' || !Array.isArray(op.path) || op.path.length !== 1 || op.path[0] !== 'preference') {
+          return { ok: false, error: { code: 'bad-request', message: '只支持设置外观偏好' } }
+        }
+        if (op.value !== 'dark' && op.value !== 'light' && op.value !== 'system') {
+          return { ok: false, error: { code: 'bad-request', message: '外观偏好只能是 dark / light / system' } }
+        }
+        nextTheme = op.value
+      }
+      if (nextTheme !== '' && target.theme !== nextTheme) {
+        target.theme = nextTheme
+        persistDevices()
+      }
+      return { ok: true, value: { ok: true } }
+    },
+  }
+}

package/src/host/rpc/subagent.js

@@ -1,27 +1,27 @@
-/**
- * subagent.* 域（1 个方法）：列出某会话的子代理。
- *
- * 从 `core.js` 搬出。顺手登记「子代理 id → 父会话 id」的缓存（`recordSubagentParents`
- * 是 core 里那张 `subagentParent` 表的写入口，面板点开某行看聊天时要用父地址读）。
- */
-export function createSubagentRpc({ getService, recordSubagentParents }) {
-  return {
-    'subagent.list': async (payload) => {
-      const parentSessionId = typeof payload?.parentSessionId === 'string' ? payload.parentSessionId : ''
-      if (parentSessionId === '') return { ok: true, value: { entries: [], parentAvailable: false } }
-      const subagents = getService('subagents')
-      if (!subagents || typeof subagents.listDescendants !== 'function') {
-        return { ok: true, value: { entries: [], parentAvailable: false } }
-      }
-      try {
-        const rows = await subagents.listDescendants(parentSessionId, new AbortController().signal)
-        // 顺手登记「子代理 id → 父会话 id」：面板点开某行看聊天时要用父地址读，
-        // 这里记住了就免去反查（每行自带 parentId，本函数的入参就是它）。
-        recordSubagentParents(rows)
-        return { ok: true, value: { entries: rows, parentAvailable: rows.length > 0 } }
-      } catch {
-        return { ok: true, value: { entries: [], parentAvailable: false } }
-      }
-    },
-  }
-}
+/**
+ * subagent.* 域（1 个方法）：列出某会话的子代理。
+ *
+ * 从 `core.js` 搬出。顺手登记「子代理 id → 父会话 id」的缓存（`recordSubagentParents`
+ * 是 core 里那张 `subagentParent` 表的写入口，面板点开某行看聊天时要用父地址读）。
+ */
+export function createSubagentRpc({ getService, recordSubagentParents }) {
+  return {
+    'subagent.list': async (payload) => {
+      const parentSessionId = typeof payload?.parentSessionId === 'string' ? payload.parentSessionId : ''
+      if (parentSessionId === '') return { ok: true, value: { entries: [], parentAvailable: false } }
+      const subagents = getService('subagents')
+      if (!subagents || typeof subagents.listDescendants !== 'function') {
+        return { ok: true, value: { entries: [], parentAvailable: false } }
+      }
+      try {
+        const rows = await subagents.listDescendants(parentSessionId, new AbortController().signal)
+        // 顺手登记「子代理 id → 父会话 id」：面板点开某行看聊天时要用父地址读，
+        // 这里记住了就免去反查（每行自带 parentId，本函数的入参就是它）。
+        recordSubagentParents(rows)
+        return { ok: true, value: { entries: rows, parentAvailable: rows.length > 0 } }
+      } catch {
+        return { ok: true, value: { entries: [], parentAvailable: false } }
+      }
+    },
+  }
+}

package/src/host/state.js

@@ -1,30 +1,30 @@
-/**
- * 宿主共享状态容器（ctxBag 的第一层）。
- *
- * 这些是**运行时可变容器**，不是模块级全局：由 core 的 createHost 创建一次，
- * 再以别名（devices/observers/...）交给闭包内的函数，以及后续搬出的 devices/sse
- * 模块使用。搬出模块时只要把 `state` 传进去即可，不需要再靠闭包捕获。
- */
-export function createHostState({ devices }) {
-  return {
-    // 设备表：deviceId -> { token, createdAt, lastSeenAt, ... }
-    devices,
-    // 当前待用的 6 位配对码（null = 没有有效码）
-    pairToken: null,
-    // 待处理：approval / question 的 rpcId 注册表（含 resolve）
-    pending: {
-      approvals: new Map(),
-      questions: new Map(),
-      byApprovalId: new Map(),
-    },
-    // SSE：设备正在看的会话、观察时间、follow 单例、流集合、每轮流式状态
-    observers: new Map(),
-    lastObservedByDevice: new Map(),
-    lastObserved: new Map(),
-    follows: new Map(),
-    streamStates: new Map(),
-    muxStreams: new Set(),
-    lastPersistedSeq: new Map(),
-    lastStep: new Map(),
-  }
-}
+/**
+ * 宿主共享状态容器（ctxBag 的第一层）。
+ *
+ * 这些是**运行时可变容器**，不是模块级全局：由 core 的 createHost 创建一次，
+ * 再以别名（devices/observers/...）交给闭包内的函数，以及后续搬出的 devices/sse
+ * 模块使用。搬出模块时只要把 `state` 传进去即可，不需要再靠闭包捕获。
+ */
+export function createHostState({ devices }) {
+  return {
+    // 设备表：deviceId -> { token, createdAt, lastSeenAt, ... }
+    devices,
+    // 当前待用的 6 位配对码（null = 没有有效码）
+    pairToken: null,
+    // 待处理：approval / question 的 rpcId 注册表（含 resolve）
+    pending: {
+      approvals: new Map(),
+      questions: new Map(),
+      byApprovalId: new Map(),
+    },
+    // SSE：设备正在看的会话、观察时间、follow 单例、流集合、每轮流式状态
+    observers: new Map(),
+    lastObservedByDevice: new Map(),
+    lastObserved: new Map(),
+    follows: new Map(),
+    streamStates: new Map(),
+    muxStreams: new Set(),
+    lastPersistedSeq: new Map(),
+    lastStep: new Map(),
+  }
+}