magic-agent 1.0.3 → 1.0.49

package/client-ui/shared/host-glue.js

@@ -0,0 +1,143 @@
+/* 组件宿主的「内核宿主符号」适配层 —— 块①
+ *
+ *  ── 它是什么 ──
+ *  对话内核（`shared/conv/*`）里有一批符号是**只用不定义**的：它们代表「宿主这一侧才知道的事」
+ *  （当前任务表、需求板、工作区、模型选择器、发送、提示……）。magic-test（掌天瓶）在自己的分片里
+ *  实现了这些；PC 工作台与移动端这两个**组件宿主**则没有这些业务件。
+ *  这份文件把缺的那 12 个补齐，让**同一份内核脚本**在组件宿主里也能加载并运行
+ *  （内核契约清单见 `manifest.json` 的 hostSymbols，校验：`node tests/check-conv-shards.mjs`）。
+ *
+ *  ── 两条纪律 ──
+ *  ① **不假装成功**：组件壳确实没有的能力（任务表 / 需求板 / 工作区切换），
+ *     返回空值并在注释里写明「这里没有」，绝不返回一个看起来成功的假结果（AGENTS.md 硬规则）。
+ *  ② **真有的能力就真转发**：发送、模型、提示这三样组件壳是有的，但状态在组件闭包里 ——
+ *     由宿主页把自己的实现挂到 `window.MagicHost` 上（见两个宿主页里的那段），这里只做转发。
+ */
+(function (global) {
+  'use strict';
+
+  /** 宿主页挂上来的能力桥：`{ send(text), model:{ name(), pick(), set(id) }, toast(msg) }`
+   *  没挂（或某一项缺）时，下面的转发一律**如实失败**（返回 false / 空串），不冒名顶替。 */
+  function bridge() { return global.MagicHost || null; }
+
+  /* ── 一、组件壳没有的业务件：诚实桩 ────────────────────────────────
+     这些桩只保证「内核拿到的回答是实话」，不代表这里真有那些功能。
+     函数型与值型分开给（见第三节的说明：值被当变量读，给函数会读出源码字符串）。 */
+
+  /** 「给任务设模型」：没有任务表，自然也没有这件事 → 明确回 false（调用方据此不做后续动作）。 */
+  function qaTaskSetModel() { return false; }
+
+  /** 工作区的短目录名（给界面显示）：本壳没有工作区切换 → 空串。 */
+  function wsDirOf() { return ''; }
+
+  /** 需求看板：只有 magic-test 工作台有它 → 本壳一律「没有这条需求」。 */
+  function reqHas() { return false; }
+
+  /** 需求看板的远端拉取：没有这条通路 → 回 null（调用方按「取不到」处理，不是抛错）。 */
+  function reqBoardFetch() { return Promise.resolve(null); }
+
+  /** 需求会话里给消息加的那点业务标注：本壳没有 → 空串（内核侧原来就是「无标注就留空」）。 */
+  function qaReqConvMsg() { return ''; }
+
+  /* ── 二、组件壳真的有的能力：转发给宿主页挂的桥（缺桥 → 如实失败）───────── */
+
+  /** 把一段话发进当前会话（内核在「重试」「追问」「提问卡作答」这些动作里会调）。
+   *  `opts.echo === false` = 「这条气泡已经画过了，别再画一遍」（内核的重试路径）。 */
+  function qaSend(text, opts) {
+    const b = bridge();
+    if (!b || typeof b.send !== 'function') return false;
+    b.send(text == null ? '' : String(text), opts || {});
+    return true;
+  }
+
+  /** 模型显示名（内核拿它渲染角色行 / 「这一轮用的哪个模型」）：没桥 → 空串 = 显示「自动」。 */
+  function qaModelName(id, eng) {
+    const b = bridge();
+    if (b && b.model && typeof b.model.name === 'function') return b.model.name(id, eng) || '';
+    return '';
+  }
+
+  /** 切换模型：没桥 → false（**不静默吞掉**，调用方会据此提示用户）。 */
+  function qaModelSet(id) {
+    const b = bridge();
+    if (!b || !b.model || typeof b.model.set !== 'function') return false;
+    b.model.set(id);
+    return true;
+  }
+
+  /** 轻提示：组件壳的提示由组件自己的提示位负责；
+   *  页面没挂桥时退到 console（**带前缀，让人一眼看出这是桩**），不假装弹过。 */
+  function toast(msg) {
+    const b = bridge();
+    if (b && typeof b.toast === 'function') { b.toast(String(msg == null ? '' : msg)); return; }
+    if (global.console && console.info) console.info('[host-glue] 本壳没有 toast：', msg);
+  }
+
+  /* ── 二·补：内核里剩下的那几个函数型宿主符号（本壳没有对应业务 → 如实降级）── */
+
+  /** 引擎/模型胶囊的提示同步：本壳的选择器由组件自己刷（syncPickers），这里无事可做。 */
+  function qaEngHintSync() { /* 没有胶囊提示可同步 */ }
+  /** 取某引擎的模型链（「自动」档的候选）：本壳的模型由 core 用配置链自己降级 → 空链。 */
+  function qaModelChainLoad() { return []; }
+  /** 「某个选择器实例会先用哪个模型」：本壳只有一个会话、模型来自 state → 读组件写回的 `qaModelPick`。 */
+  function qaModelFor() { return global.qaModelPick || ''; }
+
+  /* ── 三、皮肤件 / 状态件 ───────────────────────────────────────────
+     ⚠️ 这一批是**值**，不是函数：内核把它们当变量读 ——
+        `qaEngine || ""`、`qaWhoHtml(qaEngine, qaModel)`、`Array.isArray(qaTasks)`、
+        `qaModelPick && qaModelPick !== mdl` …
+        给成函数会得到「function …」这种字符串当引擎名（角色行上直接显示一段源码），
+        而且 `Array.isArray(函数)` 恒为 false（任务相关的降级路径全走错）。
+        值由**组件**在状态变化时写回 window（见 shared/conversation.js 的 syncHostState）。 */
+
+  /** 内核画委派卡 / 提问卡 / 工具卡用的三枚图标。这三枚是**皮**：给自洽的内联 SVG
+   *  （不引 magic-test 的 sprite，也不依赖本壳的 `<use>` 图集 —— 图标万一缺，卡片会秃一块）。 */
+  global.QA_ICONS = {
+    agent: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6"'
+      + ' stroke-linecap="round"><rect x="4" y="8" width="16" height="11" rx="3"/><path d="M12 8V5"/>'
+      + '<circle cx="9" cy="13" r="1"/><circle cx="15" cy="13" r="1"/></svg>',
+    ask: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6"'
+      + ' stroke-linecap="round"><path d="M12 4a5 5 0 0 1 5 5c0 2-1.5 3-2.5 4-.6.6-1 1-1 2"/>'
+      + '<circle cx="12" cy="18.5" r="1"/></svg>',
+    tool: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6"'
+      + ' stroke-linecap="round"><path d="M4 7h16M4 12h10M4 17h13"/></svg>',
+  };
+
+  /** 提问卡的「停靠位」清单 / 配置：magic-test 工作台有两处（home / home2），本壳只有一处，
+   *  且走固定的 `#home-askdock`（内核按 id 找它）→ 空清单：内核遍历它时什么也不做。 */
+  global.ASK_INSTANCES = [];
+  global.ASK_CFG = {};
+
+  /** PRD 后端的基址：本壳没有这个后端（产物图片走组件自己的 transport 回读）→ 空串。
+   *  内核侧既有口径是「基址为空就按相对路径处理」，不会拼出假地址。 */
+  global.prdBackendBase = '';
+
+  /* 下面这几个由组件写回真值（这里给的是「还没接上」时的初值）。 */
+  global.qaEngine = '';        // 当前引擎名
+  global.qaModel = '';         // 当前模型 id
+  global.qaModelPick = '';     // 用户手选过的模型（'' = 自动）；内核据此在降级后改选
+  global.qaEngines = [];       // 引擎清单
+  global.qaActiveId = '';      // 当前会话 id（内核的落盘 / 对账要用）
+  global.qaTasks = [];         // 任务列表：本壳是**单会话**壳，没有任务表 → 空
+  global.qaWorkspace = '';     // 本会话的工作目录：服务端维护、页面拿不到 → 空串
+
+  /* 头像（**可选**符号，内核读不到会退到自己的中性兜底，见 shared/conv/03-chat-message.js）：
+     · bot 侧：本壳的资产目录里**没有** magic-test 那张应用图标 `assets/icon.png`
+       → 给空串 = 「没有这张图」，内核改用一枚中性机器人头（否则每条助手消息左上角是裂图）；
+     · 用户侧：本壳没有工作台那个 `#nu-name` 显示名 → 不给 `QA_USER_INITIAL`，
+       内核退到「我」（**不会**顶出别人的姓名首字）。 */
+  global.QA_BOT_AVATAR_SRC = '';
+
+  global.qaSend = qaSend;
+  global.qaModelName = qaModelName;
+  global.qaModelSet = qaModelSet;
+  global.qaModelFor = qaModelFor;
+  global.qaModelChainLoad = qaModelChainLoad;
+  global.qaEngHintSync = qaEngHintSync;
+  global.qaTaskSetModel = qaTaskSetModel;
+  global.qaReqConvMsg = qaReqConvMsg;
+  global.wsDirOf = wsDirOf;
+  global.reqHas = reqHas;
+  global.reqBoardFetch = reqBoardFetch;
+  global.toast = toast;
+})(window);

package/client-ui/shared/transport-http.js

@@ -10,8 +10,15 @@
  *    GET  /desk/engines?models=1                      引擎 + 模型 + 每引擎能力
  *    POST /desk/ask                                   SSE：open / 事件 / end
  *    POST /desk/ask/{id}/control                      打断 / 收工 / 回答案
+ *    GET  /desk/asks                                  本进程正在跑的轮次（打开运行中会话续传用）
+ *    GET  /desk/ask/{id}/events?after=<seq>           断线续传：按 seq 增量补拉本轮事件
  *    GET  /desk/session/{id}/messages                 全量历史
  *    GET  /desk/session/{id}/events?after=<seq>       增量续读
+ *    POST /desk/upload                                原子化上传附件（返回本机路径 + 回读 url）
+ *    GET  /desk/uploads/{name}?token=…                回读附件（缩略图；<img> 只能走 ?token=）
+ *    GET  /desk/media?path=<abs>&w=<px>               按绝对路径回读媒体（w = 移动端缩略图宽度）
+ *    POST /desk/path-probe                            一批本机路径的存在性探测（画产物用）
+ *    POST /desk/path-read                             读文本文件（产物卡「查看」阅读用）
  *
  *  ── 用法 ──
  *    const transport = MagicTransportHttp({ base: '', token: '…' });   // 同源时 base 传空串
@@ -24,12 +31,23 @@
     opts = opts || {};
     var BASE = String(opts.base || '').replace(/\/+$/, '');
     var TOKEN = opts.token || '';
+    // 发起方自报的客户端类型（'mobile' | 'pc'）：随每个 ask 请求带给服务端，
+    // 用于会话列表上的**来源标志**（同源时 Origin 分不出来，只能靠自报）。
+    var CLIENT = String(opts.client || '').trim();
 
     function hdr(extra) {
       var h = extra || {};
       if (TOKEN) h['X-Magic-Token'] = TOKEN;
       return h;
     }
+
+    /* 移动端慢网取图统一走 720 宽缩略图（服务端按需缩放；解不了 / 非图片自动回原文件）。
+       返回 '' 或 '<sep>w=720'：由调用方拼在已有 query 之后。 */
+    function thumbQuery(path, sep) {
+      if (CLIENT !== 'mobile') return '';
+      if (!/\.(?:png|jpe?g|gif|bmp|webp)$/i.test(String(path))) return '';
+      return sep + 'w=720';
+    }
     function api(path, o) {
       o = o || {};
       o.headers = hdr(o.headers);
@@ -39,7 +57,11 @@
         o.body = JSON.stringify(o.json);
       }
       return fetch(BASE + path, o).then(function (r) {
-        if (!r.ok) throw new Error(r.status + ' ' + r.statusText);
+        if (!r.ok) {
+          var err = new Error(r.status + ' ' + r.statusText);
+          err.status = r.status;   // 调用方要区分 404（无法续传）和网络抖动
+          throw err;
+        }
         return r;
       });
     }
@@ -50,8 +72,81 @@
         return api('/desk/engines?models=1').then(function (r) { return r.json(); });
       },
 
+      /* 上传附件：返回 {path, name, size, mime, url}。path 是 core 所在机器的绝对路径，
+         由 ask 的 payload.attachments 透传给 -a/--attach；url 是回读地址（缩略图用，
+         这里补成绝对地址并带上令牌）。multipart 的 Content-Type 交给浏览器带 boundary，不要自己设。 */
+      upload: function (file) {
+        var fd = new FormData();
+        fd.append('file', file, file.name || 'upload');
+        return fetch(BASE + '/desk/upload', { method: 'POST', headers: hdr(), body: fd })
+          .then(function (r) {
+            if (r.ok) return r.json().then(function (j) {
+              /* 回读地址补成绝对 + 带令牌：<img src> 带不了 X-Magic-Token 自定义头。 */
+              if (j && j.url) {
+                j.url = BASE + j.url + (TOKEN ? (j.url.indexOf('?') >= 0 ? '&' : '?') + 'token=' + encodeURIComponent(TOKEN) : '');
+              }
+              return j;
+            });
+            return r.json().catch(function () { return {}; }).then(function (j) {
+              throw new Error(j.error || (r.status + ' ' + r.statusText));
+            });
+          });
+      },
+
+      /* 附件回读地址：由本机绝对路径推出（上传目录内文件才有）。历史回放的缩略图 src 用它；
+         <img> 带不了 X-Magic-Token 自定义头，所以令牌走 ?token=。 */
+      mediaUrl: function (path) {
+        if (!path) return '';
+        var base = String(path).split(/[\\/]/).pop();
+        if (!base) return '';
+        return BASE + '/desk/uploads/' + encodeURIComponent(base) +
+          (TOKEN ? '?token=' + encodeURIComponent(TOKEN) : '') + thumbQuery(path, TOKEN ? '&' : '?');
+      },
+
+      /* 本机任意图片文件的回读地址（工具卡缩略图用）：按**绝对路径**取。
+         <img> 带不了 X-Magic-Token 自定义头，所以令牌走 ?token=。 */
+      fileUrl: function (path) {
+        if (!path) return '';
+        return BASE + '/desk/media?path=' + encodeURIComponent(path) +
+          (TOKEN ? '&token=' + encodeURIComponent(TOKEN) : '') +
+          thumbQuery(path, '&');
+      },
+
+      /* 一批本机路径的**存在性探测**（内核画「会话产物」用，见 shared/conv/19-attachments.js）：
+         入参 {base, paths[]}，回 {ok, items:[{path, abs, exists, size}]}。
+         相对路径由服务端按 base（会话的 workspace）解析；服务端就在 core 那台机器上。 */
+      pathProbe: function (req) {
+        var body = {
+          base: (req && req.base) || '',
+          paths: (req && Array.isArray(req.paths)) ? req.paths : [],
+        };
+        return api('/desk/path-probe', { json: body }).then(function (r) { return r.json(); });
+      },
+
+      /* 按路径读一个**文本**文件（内核产物卡「查看」用）：入参 {path, base}，
+         出参与桌面端 desk:path-read 一致 —— {ok, text, size, path} /
+         {ok, tooBig, size} / {ok, binary, size} / {ok:false, error}。 */
+      pathRead: function (req) {
+        var body = {
+          path: (req && req.path) || '',
+          base: (req && req.base) || '',
+        };
+        return api('/desk/path-read', { json: body }).then(function (r) { return r.json(); });
+      },
+
+      /* 会话标题覆盖表 {sid: title}（插件侧持久化，重命名用）。 */
+      listTitles: function () {
+        return api('/desk/titles').then(function (r) { return r.json(); });
+      },
+      setTitle: function (id, title) {
+        return api('/desk/session/' + encodeURIComponent(id) + '/title',
+          { method: 'PUT', json: { title: title || '' } }).then(function (r) { return r.json(); });
+      },
+
       /* 一轮：把 SSE 拆成三个回调交给组件，组件不关心里面是 SSE 还是别的。 */
       ask: function (payload, h) {
+        var body = payload || {};
+        if (CLIENT && !body.client) body.client = CLIENT;
         var aborted = false;
         var ctl = typeof AbortController !== 'undefined' ? new AbortController() : null;
         var ended = false;
@@ -60,7 +155,7 @@
           ended = true;
           if (h && h.onEnd) h.onEnd(code);
         };
-        api('/desk/ask', { json: payload, signal: ctl ? ctl.signal : undefined })
+        api('/desk/ask', { json: body, signal: ctl ? ctl.signal : undefined })
           .then(function (resp) {
             var reader = resp.body.getReader(), dec = new TextDecoder(), buf = '';
             return (function pump() {
@@ -105,15 +200,44 @@
           .then(function () { return true; });
       },
 
+      /* 本进程**正在跑**的轮次（每项 {id, engine, started, session?}）。
+         打开一条「还在跑」的会话时用它认出同一会话的运行中轮次，把画面接回实时流：
+         历史只重放到最后一条 user，其余从 ask 缓冲按 seq 补齐（见 conversation.js 的
+         tailAsk / attachRunningAsk）。拿不到 session 的旧服务端就当没有 —— 退回全量回放。 */
+      listAsks: function () {
+        return api('/desk/asks').then(function (r) { return r.json(); });
+      },
+
+      /* 断线续传：按 seq 增量拿本轮还没画过的事件。
+         返回 {id, events, count, after, lastSeq, done, code, stderr, snapshotRequired}。
+         events 是 core 原样的事件对象，形状与 SSE 里逐条到达的完全一致；
+         done 之后 code/stderr 才有意义。服务端只保留有限时间窗，过期返回 404。 */
+      askEvents: function (id, after) {
+        var q = after == null ? '' : '?after=' + encodeURIComponent(after);
+        return api('/desk/ask/' + encodeURIComponent(id) + '/events' + q)
+          .then(function (r) { return r.json(); });
+      },
+
       readSession: function (id, o) {
         o = o || {};
-        /* 有游标就走增量接口：长会话下差一个数量级。
-           形状与全量接口不同（多 lastSeq / snapshotRequired），一并原样交给组件。 */
+        /* 一律带 lean=1：服务端会裁掉每条事件的累积 snapshot（与 --session-log-lean 同口径）。
+           长会话的 snapshot 是二次方膨胀（实测 9.4 万条 thinking = 283MB），不裁就要在浏览器里
+           解析/传输整份 300MB+ JSON —— 移动端打开历史卡十几秒的主因。回放只用增量 text，裁掉不影响画面。
+           老服务端会忽略这个未知参数，行为退回旧版（只是慢）。 */
         if (o.after != null) {
-          return api('/desk/session/' + encodeURIComponent(id) + '/events?after=' + o.after)
+          return api('/desk/session/' + encodeURIComponent(id) + '/events?after=' + o.after + '&lean=1')
+            .then(function (r) { return r.json(); });
+        }
+        /* 反向分页：before = 从文件尾跳过多少条（不是 seq），limit = 本次最多要多少条。
+           服务端保证一页至少含一个轮次起点（user），所以相邻页不会把同一轮切成两半。
+           老服务端忽略未知参数 → 仍返回全量且**没有 more 字段**，调用方据此退回旧行为。 */
+        if (o.before != null) {
+          var q = '?lean=1&before=' + encodeURIComponent(o.before);
+          if (o.limit != null) q += '&limit=' + encodeURIComponent(o.limit);
+          return api('/desk/session/' + encodeURIComponent(id) + '/messages' + q)
             .then(function (r) { return r.json(); });
         }
-        return api('/desk/session/' + encodeURIComponent(id) + '/messages')
+        return api('/desk/session/' + encodeURIComponent(id) + '/messages?lean=1')
           .then(function (r) { return r.json(); });
       }
     };