dsh-mobile-plugin 0.5.27 → 0.5.29

package/lib/mobile/host-bridge/endpoints.js

@@ -124,12 +124,7 @@ const ENDPOINTS = {
       delivery: (p && p.delivery) || 'queue',
     },
   })),
-  'subagents.interrupt': (ctx, payload, signal) =>
-    invoke(ctx, 'subagents', 'interruptByParent', {
-      childSessionId: payload.childSessionId,
-      parentSessionId: payload.parentSessionId,
-      mode: payload.mode || 'continuable',
-    }, signal).then((r) => (r.error ? fail(r.error) : ok(r.value))),
+  'subagents.interrupt': (ctx, payload, signal) => subagentInterrupt(ctx, payload, signal),
   'subagents.list': (ctx, payload, signal) => subagentCatalog(ctx, payload, signal),
 
   // goals：objective 被宿主挪进了 request 里
@@ -174,6 +169,53 @@ function goalAction(ctx, method, payload, signal) {
     .then((r) => (r.error ? fail(r.error) : ok(r.value)));
 }
 
+/**
+ * 打断可继续子代理当前这一轮。
+ *
+ * 上游 0.2.1-rc.2 起把旧的 `interruptByParent(childSessionId, parentSessionId, mode)`
+ * 换成了 `interruptByUser(childSessionId)`：新接口只按子会话 id 打断，授权挂在子会话本身
+ * （`@Remote({ name: 'interruptByUser', resources: { session: childSessionId => childSessionId } })`），
+ * 不再需要父会话 id 和 mode。老宿主上旧的 `interruptByParent` 还在，所以这里做兜底：
+ * 先打新接口，宿主没有这个新方法就退回旧接口。
+ *
+ * 失败信息要能分清是哪一种，别把「宿主没有这个方法」和「打断本身失败」混成一句：
+ *  - 新接口存在但打断失败（网关回的是别的业务错误码，例如 gateway/internal）→ 直接如实
+ *    报那一发，**不退回**；退回只会把真失败伪装成「没这个接口」。
+ *  - 新接口不存在（`host-unavailable`，即老宿主）→ 退回旧接口，旧接口成功就算成功。
+ *  - 两个接口都不存在 → 明确报「宿主没有打断接口」，这跟「打断失败」是两回事。
+ *  - 退回旧接口后真的打断失败 → 报旧接口的错误，它才是这一次真实的结果。
+ *
+ * App 侧 payload 仍是 `{ parentSessionId, childSessionId }`（`subagents.js` 还补了 mode）：
+ * 新接口要的 `childSessionId` 正好在里面，参数名不用改；父会话 id / mode 只给旧接口用。
+ */
+async function subagentInterrupt(ctx, payload, signal) {
+  const childSessionId = payload && payload.childSessionId;
+  const next = await invoke(ctx, 'subagents', 'interruptByUser', { childSessionId }, signal);
+  if (!next.error) return ok(next.value);
+
+  // 新接口不存在 = 老宿主，退回旧的 interruptByParent。
+  if (next.error.code === 'host-unavailable') {
+    const legacy = await invoke(ctx, 'subagents', 'interruptByParent', {
+      childSessionId,
+      parentSessionId: payload && payload.parentSessionId,
+      mode: (payload && payload.mode) || 'continuable',
+    }, signal);
+    if (!legacy.error) return ok(legacy.value);
+    // 旧接口也不存在：宿主根本没有打断能力，与「打断失败」区分开。
+    if (legacy.error.code === 'host-unavailable') {
+      return fail({
+        code: 'host-unavailable',
+        message: '当前宿主版本没有提供子代理打断接口（interruptByUser / interruptByParent 都不存在）',
+      });
+    }
+    // 旧接口存在但打断失败：如实报旧接口的错误。
+    return fail(legacy.error);
+  }
+
+  // 新接口存在但打断失败：如实报，不退回。
+  return fail(next.error);
+}
+
 /**
  * 宿主只服务 native 选择器时的清单条（**不回落到网关**）。
  *

package/lib/mobile/host-bridge/event-synthesis.js

@@ -244,9 +244,14 @@ async function* sessionJobFrames(ctx, sessionId, signal) {
  * 投影整帧（排队条、计划条、目标条、模型选择等全量快照）。
  *
  * 宿主 session.control 是设备级投影流：首帧 baseline 一次性给出
- * { projections: { [sessionId]: { asOfSeq, values } } }，之后是
- * { type:'projection', sessionId, key, value, seq } 的单键更新。
- * 旧帧是整帧（幂等全量），这里保持整帧语义 —— 更新帧就带上累积后的 values 重发。
+ * { projections: { [sessionId]: { asOfSeq, values } } }，之后是 live 变化帧。
+ * live 帧有两种形状：0.2.0 及更早是「一 key 一帧」的
+ * { type:'projection', sessionId, key, value, seq }，0.2.2-alpha.2 起改成「一个 committed
+ * event 一帧」的 { type:'projection', sessionId, seq, changes:[{ key, val }] } —— 同一次
+ * 事件改掉的键全在这一帧里、共用一个 seq。两种都得认，否则宿主管家升上去之后投影会停在
+ * 首帧：排队条、计划条、模型选择、上下文统计一起不动。
+ *
+ * 对外仍是整帧（幂等全量），这里保持整帧语义 —— 更新帧就带上累积后的 values 重发。
  */
 function projectionState() {
   const values = new Map();   // sessionId -> { asOfSeq, values }
@@ -265,11 +270,33 @@ function projectionState() {
       }
       return touched;
     },
+    /**
+     * 一帧 live 变化 → 累积后的整帧。
+     *
+     * 新形状一次带多个 change，按 `changes` 顺序全部应用（后来的同名键覆盖前面的）；
+     * 旧形状只有单个 key/value。认不出的帧不抛错也不动 values —— 这条流后面还接着
+     * baseline 和别的会话，一帧脏数据不该把整条投影流打断。
+     */
     applyUpdate(update) {
-      const sessionId = update && update.sessionId;
-      if (typeof sessionId !== 'string') return [];
+      if (!update || typeof update !== 'object') return [];
+      const sessionId = update.sessionId;
+      if (typeof sessionId !== 'string' || !sessionId) return [];
+      const changes = [];
+      if (Array.isArray(update.changes)) {
+        for (const change of update.changes) {
+          if (!change || typeof change !== 'object') continue;
+          if (typeof change.key !== 'string' || !change.key) continue;
+          changes.push([change.key, change.val]);
+        }
+      } else if (typeof update.key === 'string' && update.key) {
+        changes.push([update.key, update.value]);
+      }
+      if (changes.length === 0 && !Number.isSafeInteger(update.seq)) return [];
       const current = values.get(sessionId) || { asOfSeq: 0, values: {} };
-      if (typeof update.key === 'string') current.values = { ...current.values, [update.key]: update.value };
+      let nextValues = current.values;
+      for (const [key, val] of changes) nextValues = { ...nextValues, [key]: val };
+      current.values = nextValues;
+      // seq 是「造成这批变化的那个 committed event」的序号；一帧里多个 change 共用它。
       if (Number.isSafeInteger(update.seq)) current.asOfSeq = update.seq;
       values.set(sessionId, current);
       return [sessionId];

package/lib/mobile/jobs-control.js

@@ -0,0 +1,118 @@
+'use strict';
+
+/**
+ * 后台任务的启停控制。
+ *
+ * 宿主把后台任务拆成两半：
+ *  - 读：`session/jobs` 帧（`jobs.js` 只做形状收敛）与 `jobController` 的流式 `list` /
+ *    `follow`（桌面端的任务面板用）。手机端已有的 `jobs` 帧已经能显示「进行中 N / 共 M」。
+ *  - 写：宿主 `JobController` 只公开一条 `kill`（`job/kill`，人类代删，reason 记
+ *    「cancelled by the user」，owner 仍会收到完成通知）。它接 `{ sessionId, jobId }`，
+ *    回 `{ outcome: 'requested' | 'already-finished' }`，任务看不见时抛 `job/not-found`。
+ *
+ * 所以**取消能接，启动接不了**：`ctx.jobs.start()` 是给 bash / PTY 之类「生产者」用的
+ * 内部 seam，`tool-jobs` 插件靠它把命令跑起来；移动 API 一旦放开「启动」就等于放开「跑任意
+ * 命令」，直接撞上「不暴露 shell」那条能力边界。这里给启动一条显式 501（`jobs-start-
+ * unsupported`），让 App 能明确显示「这台电脑只能看和取消，不能从这里起任务」，而不是装作
+ * 成功或 404。
+ *
+ * 服务同进程直查 `ctx.get('jobController')`，不写进 inject：老宿主没有它时只该让这一条
+ * 路由回 503，不该影响整个插件装配。没有这个服务就回 503（与 schedule 那套同口径）。
+ */
+
+const { sendJson, readJsonBody } = require('../shared/http-util');
+
+const JOB_ID_MAX = 200;
+const SESSION_ID_MAX = 200;
+
+/** 宿主没有后台任务控制服务时的统一回答。 */
+const UNAVAILABLE = Object.freeze({
+  code: 'jobs-unavailable',
+  message: '宿主没有后台任务控制服务',
+});
+
+/** 启动能力的统一回答：宿主不提供，只能取消。 */
+const START_UNSUPPORTED = Object.freeze({
+  code: 'jobs-start-unsupported',
+  message: '宿主的移动 API 不能启动后台任务，只能查看与取消',
+});
+
+/** 必填文本：非字符串或全空白 → ''；超长截断。 */
+function requiredText(value, max) {
+  if (typeof value !== 'string') return '';
+  const text = value.trim();
+  if (!text) return '';
+  return text.length > max ? text.slice(0, max) : text;
+}
+
+/** 错误文字：宿主 reject 的原文，取不到就退回 String()。 */
+function errorText(error) {
+  if (error === undefined || error === null) return '未知错误';
+  if (typeof error.message === 'string' && error.message) return error.message;
+  return String(error);
+}
+
+/** 同进程直查 `jobController`；拿不到返回 null。 */
+function jobControllerService(ctx) {
+  try {
+    if (!ctx || typeof ctx.get !== 'function') return null;
+    return ctx.get('jobController') || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * POST /api/mobile/v1/jobs/cancel
+ * body { sessionId?, jobId }  —— 取消一条后台任务。
+ *
+ * `sessionId` 取任务那一帧上带的会话（owner fence）：宿主只让会话看得见的任务被取消。
+ * 无主任务可以不传；传了也不会错。
+ */
+async function handleJobsCancel(ctx, req, res) {
+  const body = (await readJsonBody(req)) || {};
+  const sessionId = requiredText(body.sessionId, SESSION_ID_MAX);
+  const jobId = requiredText(body.jobId ?? body.id, JOB_ID_MAX);
+  if (!jobId) {
+    return sendJson(res, 400, { ok: false, error: { code: 'invalid_selector', message: '需要 jobId' } });
+  }
+
+  const service = jobControllerService(ctx);
+  if (!service || typeof service.kill !== 'function') {
+    return sendJson(res, 503, { ok: false, error: { ...UNAVAILABLE } });
+  }
+
+  let result;
+  try {
+    result = await service.kill({ sessionId, jobId });
+  } catch (error) {
+    const code = error && typeof error.code === 'string' ? error.code.trim() : '';
+    if (code === 'job/not-found' || /not[\s-]?found/i.test(errorText(error))) {
+      // 任务已经不在了不算大错：手机刷新一下就没有它了。
+      return sendJson(res, 404, { ok: false, error: { code: 'job-not-found', message: '没有这个后台任务' } });
+    }
+    return sendJson(res, 502, { ok: false, error: { code: 'jobs_failed', message: errorText(error) } });
+  }
+
+  const outcome = result && typeof result === 'object' ? result.outcome : result;
+  sendJson(res, 200, {
+    ok: true,
+    id: jobId,
+    outcome: typeof outcome === 'string' && outcome ? outcome : 'requested',
+  });
+}
+
+/**
+ * POST /api/mobile/v1/jobs/start —— 宿主不提供这个能力，显式 501。
+ *
+ * 保留这条是为了让 App 能拿到一个明确答复（据此决定按钮显不显示 / 怎么写提示），
+ * 而不是靠 404 猜。真要支持启动，得先改设计：那等于让移动端跑任意命令。
+ */
+async function handleJobsStart(_ctx, _req, res) {
+  sendJson(res, 501, { ok: false, error: { ...START_UNSUPPORTED } });
+}
+
+module.exports = {
+  handleJobsCancel,
+  handleJobsStart,
+};