dsh-agent-tasks 0.1.1 → 0.1.2

package/index.js

@@ -1,1977 +1,2031 @@
-/**
- * dsh-agent-tasks — AI-Agent-Hub 的任务线 / agent 通信工具。
- *
- * 2026-11-10 起从这里起步：先把 **agent_message**（146 行、只依赖 hub.get、完全自包含）
- * 从 hub-desktop-ui/index.js 的 register 块（原 L6191-6337）搬过来，作为拆包的样板。
- * 其余 11 个工具按同样方法逐个搬入（各自依赖已在拆包前查清：sessions / hub.get /
- * core 的 projectOfSessionTitle+hostRoot / clone-handoff 的 collectEvents）。
- *
- * 用法（hub-desktop-ui 里）：
- *   import { registerAgentTools } from 'dsh-agent-tasks';
- *   const disposers = registerAgentTools({ hub, register, deps });
- */
-export const PACKAGE_VERSION = '0.1.0';
-
-/**
- * 注册本包负责的工具。
- * @param {{ hub: object, register: (definition: object) => unknown, deps?: object }} opts
- * @returns {unknown[]} disposers（与 tools.register 的返回值一致）
- */
-import { existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { randomUUID } from 'node:crypto';
-import { homedir, tmpdir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
-import { collectEvents, writeCloneHandoff } from 'dsh-clone-handoff';
-import {
-  agentNameOfTitle,
-  cleanCloneRegistry,
-  dedupeActiveTitles,
-  deliveryConclusion,
-  ensureLiveSession,
-  ensureMemberAvatar,
-  goalDirective,
-  guardRoutingFile,
-  hostRoot,
-  INTERRUPT_IDLE_WAIT_MS,
-  isQueueTriageTitle,
-  looksTaskSpecificName,
-  noticeMessage,
-  planDelivery,
-  projectOfSessionTitle,
-  pruneArchivedSessions,
-  readJsonForWrite,
-  readRegisteredSessionIds,
-  readTaskFile,
-  renderTasklinePrompt,
-  resumeInterruptedSessions,
-  setTaskGoal,
-  writeJsonAtomic,
-  resumeLedgerPath,
-  RESUME_PROMPT,
-  RESUME_MAX_PER_BOOT,
-  titleOf,
-  readGlobalAvatars,
-  writeGlobalAvatar,
-  AVATAR_POOL,
-  recordResumeSweep,
-  shouldSkipResumeByLedger,
-  projectsDir,
-  boardPath,
-  tasksPath,
-  routingPath,
-  handoffsDir,
-  triageDecisionOf,
-  readSessionEvents,
-  compactSessionEvents,
-} from 'dsh-hub-core';
-
-export function registerAgentTools({ hub, register, deps = {} }) {
-  // defaultPreset（2026-11-10 修）：12 个工具迁出 hub-desktop-ui 时漏注入了这个。
-  // 因为 taskline_create 里写的是 `args.preset || defaultPreset`（短路求值），
-  // 只要调用方传了 preset 就永远不会求值 → 一直没暴露；
-  // 一旦不传 preset 就直接 ReferenceError: defaultPreset is not defined。
-  // 兜底 'cordis' 与 hub-desktop-ui 那边 `config.defaultPreset || 'cordis'` 保持一致。
-  const { callerTitleOf, isRunningNow, pendingDispatchesOf, recordDispatch, resolveSession, snapshotTargetRunning, spawnQueueTriage, titleOfSession, waitForAgentIdle, wakeAgentMessageTarget, liveRunning, queueTriageEnabled, defaultPreset = 'cordis' } = deps;
-  const disposers = [];
-
-  // —— agent_message（2026-10-23 用户令；原 hub-desktop-ui L6191-6337）——
-  disposers.push(register({
-        name: 'agent_message',
-        description: '给任意 agent（含其它项目）直接发一条消息：讨论、要资料、同步状态、协作求解。'
-          + '交流放行（跨项目可用）；正式任务分派仍走本项目管理者的 taskline_prompt。'
-          + 'mode 默认 steer=**中途插队**（目标在跑时在下一个 step 边界插入当前轮，不打断正在执行的工具；目标空闲自动退化为排队），'
-          + 'mode=queue 才是排队等回合结束。'
-          + '别用它给忙碌的 agent 反复轰炸转派任务——接活请走管理者。',
-        parameters: {
-          type: 'object',
-          additionalProperties: false,
-          required: ['target', 'text'],
-          properties: {
-            target: { type: 'string', description: '目标：完整 sessionId 或「项目 · 成员」标题（可部分匹配）' },
-            text: { type: 'string', description: '要说的话（会自动加【来自 <你>】前缀）' },
-            replyExpected: { type: 'boolean', description: 'true 时文末提示对方回一句（默认不加）' },
-            mode: {
-              type: 'string',
-              enum: ['steer', 'queue'],
-              description: '投递模式：steer（默认）= 目标在跑时插进当前轮的下一个 step 边界（不打断当前工具调用；目标空闲退化为排队）；'
-                + 'queue = 排队等它当前回合结束',
-            },
-          },
-        },
-        output: {
-          schema: {
-            type: 'object',
-            additionalProperties: false,
-            required: ['ok'],
-            properties: {
-              ok: { type: 'boolean' },
-              sessionId: { type: 'string' },
-              targetTitle: { type: 'string' },
-              crossProject: { type: 'boolean' },
-              callerTitle: { type: 'string' },
-              ambiguous: { type: 'boolean' },
-              candidates: { type: 'array', items: { type: 'string' } },
-              mode: { type: 'string' },
-              woke: { type: 'boolean' },
-              wakeNote: { type: 'string' },
-              error: { type: 'string' },
-            },
-          },
-          render: (_args, value) => [{
-            type: 'text',
-            text: value.ok
-              ? `已发给「${value.targetTitle}」${value.crossProject ? '（跨项目）' : ''}${value.woke ? '，并已唤醒它开始回复' : (value.wakeNote ? `（未唤醒：${value.wakeNote}）` : '')}`
-              : (value.ambiguous
-                ? `命中多个会话，请用完整 sessionId 重发：\n${(value.candidates || []).join('\n')}`
-                : `发送失败：${value.error || 'unknown'}`),
-          }],
-        },
-        async execute(args, exec) {
-          const controller = hub.get('sessionController');
-          if (!controller || typeof controller.prompt !== 'function') {
-            return { ok: false, error: 'sessionController 不可用' };
-          }
-          // P8-①（2026-10-29）：text 缺失/非字符串时拒绝投递（同 taskline_prompt 防 undefined）
-          if (typeof args.text !== 'string' || !args.text.trim()) {
-            return { ok: false, error: '缺少 text（收到 undefined/空/非字符串）。请检查 agent_message 调用参数后重发；本条未投递。' };
-          }
-          const ref = String(args.target || '').trim();
-          const isExactId = /^session-[0-9a-f-]{20,}$/i.test(ref);
-          // 目标解析：完整 id 直用；标题片段跨**全部项目**清点（同名列候选）
-          let session = isExactId ? deps.resolveSession(ref) : undefined;
-          let ambiguity = null;
-          if (!session) {
-            try {
-              const value = await controller.list(new AbortController().signal);
-              const rows = value && Array.isArray(value.items) ? value.items : (Array.isArray(value) ? value : []);
-              const registry = hub.get('workspaceRegistry');
-              const archivedSet = new Set(
-                registry && Array.isArray(registry.archivedSessionIds)
-                  ? registry.archivedSessionIds.map(String) : [],
-              );
-              const candidates = [];
-              for (const row of rows) {
-                if (!row || !row.sessionId || archivedSet.has(String(row.sessionId))) continue;
-                const t = row.projections && row.projections.values && typeof row.projections.values.title === 'string'
-                  ? row.projections.values.title : '';
-                if (!t || !t.includes(ref)) continue;
-                candidates.push({ id: String(row.sessionId), title: t });
-              }
-              if (candidates.length === 1) {
-                session = { id: candidates[0].id, displayTitle: candidates[0].title };
-              } else if (candidates.length > 1) {
-                ambiguity = candidates;
-              }
-            } catch (error) { /* 清点失败退回 live 解析 */ }
-          }
-          if (!session) session = deps.resolveSession(ref);
-          if (ambiguity && ambiguity.length > 1) {
-            return {
-              ok: false,
-              ambiguous: true,
-              candidates: ambiguity.map((c) => `${c.title} ${c.id}`),
-              error: '同名多个会话',
-            };
-          }
-          if (!session) return { ok: false, error: '找不到这个会话（可用 taskline_list 查完整 sessionId）' };
-          // 唤醒 + 投递（ensureLiveSession 每次 resolveAgent，冷会话也能收）
-          const live = await ensureLiveSession(hub, controller, String(session.id));
-          if (!live.ok) return { ok: false, error: live.error || '会话不可用' };
-          const callerAgent = exec && exec.agent;
-          const callerTitle = callerAgent ? deps.callerTitleOf(callerAgent) : '';
-          const targetTitle = deps.titleOfSession(live.session) || session.displayTitle || '';
-          const projectOfTitle = (t) => (t && t.includes(' · ') ? t.slice(0, t.lastIndexOf(' · ')).trim() : '');
-          const crossProject = Boolean(
-            projectOfTitle(callerTitle) && projectOfTitle(targetTitle)
-            && projectOfTitle(targetTitle) !== projectOfTitle(callerTitle),
-          );
-          const body = `【来自 ${callerTitle || '某 agent'}】${String(args.text || '').trim()}`
-            + (args.replyExpected ? '\n（方便的话回我一句）' : '');
-          // 投递模式（2026-10-23 用户令「要可以中途插队」）：默认 steer。
-          // steer = 目标在跑时在下一个 step 边界插入当前轮（不打断正在执行的工具调用）；
-          // 目标空闲时 DSH 侧自动退化为排队 —— 所以如实回报「实际生效模式」。
-          const requestedMode = args.mode === 'queue' ? 'queue' : 'steer';
-          let targetRunning = false;
-          try {
-            const agents = hub.get('agents');
-            const agent = agents && typeof agents.get === 'function' ? agents.get(String(live.session.id)) : undefined;
-            targetRunning = Boolean(agent && String(agent.status) === 'running');
-          } catch (error) { /* 取不到就按空闲处理 */ }
-          const effectiveMode = requestedMode === 'steer' && !targetRunning ? 'queue' : requestedMode;
-          try {
-            await controller.prompt({
-              requestId: `agent-msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
-              sessionId: String(live.session.id),
-              mode: requestedMode,
-              content: [{ type: 'text', text: body }],
-            }, new AbortController().signal);
-            // P3（2026-10-27 杨航拍板「允许跨项目自动唤醒」）：投递后若目标仍空闲，
-            // 复用 resume_session 的同一实现唤醒一次，避免只建空 turn（lastTurn+1 / response=""）。
-            const wake = await deps.wakeAgentMessageTarget(String(live.session.id));
-            return {
-              ok: true,
-              sessionId: String(live.session.id),
-              targetTitle,
-              crossProject,
-              callerTitle,
-              mode: effectiveMode,
-              ...(wake.woke ? { woke: true } : {}),
-              ...(wake.reason ? { wakeNote: wake.reason } : {}),
-            };
-          } catch (error) {
-            return { ok: false, error: String((error && error.message) || error) };
-          }
-        },
-      }
-  ));
-
-  // —— vision_read ——
-  disposers.push(register({
-    name: 'vision_read',
-    description: '⛔【视觉模型调用即违规】能收图的模型（inputModalities 含 image）请直接读附件或 read_image，**不要调用本工具**——'
-      + '本工具仅供**确认无图像输入能力的纯文本模型**兜底。'
-      + '功能：让视觉模型替你看图，返回文字结果（描述 / 针对某个问题回答 / OCR 逐字转写）。'
-      + '违反示例：视觉模型调用它 = 把原图转述成有损文字、多跳一次常失败的后端、浪费 token。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['source'],
-      properties: {
-        source: { type: 'string', description: '图片路径：绝对路径、~ 开头或 file:// URL；无扩展名也能识别（按文件头）' },
-        question: { type: 'string', description: '要问的问题；省略则返回整体描述' },
-        ocr: { type: 'boolean', description: 'true = 逐字转写图中所有文字（此时忽略 question）' },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['ok', 'text'],
-        properties: {
-          ok: { type: 'boolean' },
-          text: { type: 'string' },
-          error: { type: 'string' },
-        },
-      },
-      render: (_args, value) => [{
-        type: 'text',
-        text: value.ok ? value.text : `vision_read 失败：${value.error || '未知原因'}`,
-      }],
-    },
-    timeoutMs: 300000,
-    async execute(args, exec) {
-      // ① 提示视觉模型"你本来就能看图"（2026-10-26 软化：不再硬拒答——
-      // 客户端拦截后图片以路径文本进会话，视觉模型拿不到附件内容时也该能代看，
-      // 否则会出现"路径给了但谁也看不了"的死角）。判定不出就照常工作。
-      let visionModelNote = '';
-      try {
-        const llm = hub.get('llm');
-        let selection;
-        try {
-          const agentsSvc = hub.get('agents');
-          const ref = agentsSvc && typeof agentsSvc.selectionFor === 'function'
-            ? agentsSvc.selectionFor(exec.agent) : undefined;
-          selection = ref && ref.current;
-        } catch (error) { /* 忽略 */ }
-        if (!selection && exec.agent && typeof exec.agent.currentSelection === 'function') {
-          selection = exec.agent.currentSelection();
-        }
-        if (selection && llm && typeof llm.resolveModelInfo === 'function') {
-          const info = await llm.resolveModelInfo(selection.provider, selection.model, exec.signal);
-          const modalities = info && info.inputModalities;
-          if (Array.isArray(modalities) && modalities.includes('image')) {
-            visionModelNote = `\n\n[注：当前模型（${selection.model}）支持图像输入；若你能直接看到该图片附件，优先以原生视图为准。]`;
-          }
-        }
-      } catch (error) { /* 判定失败：继续执行 */ }
-
-      // ② 定位 vision-tools 工具包
-      const toolkitCandidates = [
-        process.env.DSH_VISION_TOOLKIT,
-        join(homedir(), 'Documents', 'GitHub', 'AI-Agent-Hub', 'skills', 'vision-tools'),
-        join(homedir(), '.dsh', 'skills', 'vision-tools'),
-      ].filter(Boolean);
-      const toolkit = toolkitCandidates.find((dir) => existsSync(join(dir, 'bin', 'glance')));
-      if (!toolkit) {
-        return { ok: false, text: '', error: `找不到 vision-tools（试过：${toolkitCandidates.join(' | ')}）` };
-      }
-      const scriptsDir = join(toolkit, 'scripts');
-
-      // ③ python 解释器
-      const pythonCandidates = [
-        process.env.DSH_VISION_PYTHON,
-        join(process.env.LOCALAPPDATA || '', 'Programs', 'Python', 'Python313', 'python.exe'),
-        'python',
-      ].filter(Boolean);
-      const python = pythonCandidates.find((exe) => exe === 'python' || existsSync(exe)) || 'python';
-
-      // ④ 图片路径 + 扩展名归一（DSH 附件对象名是 sha256，没有扩展名）
-      let raw = String(args.source || '').trim();
-      if (!raw) return { ok: false, text: '', error: 'source 不能为空' };
-      if (raw.startsWith('file://')) {
-        try { raw = decodeURIComponent(new URL(raw).pathname).replace(/^\/([A-Za-z]:)/, '$1'); } catch (error) { /* 保留原样 */ }
-      }
-      if (raw.startsWith('~')) raw = join(homedir(), raw.slice(1));
-      const imagePath = resolve(raw);
-      if (!existsSync(imagePath)) return { ok: false, text: '', error: `图片不存在：${imagePath}` };
-      const knownExt = /\.(png|jpe?g|gif|webp)$/i.test(imagePath);
-      let stagedPath = imagePath;
-      let tempPath = '';
-      if (!knownExt) {
-        let magic = '';
-        try { magic = readFileSync(imagePath).subarray(0, 12).toString('latin1'); } catch (error) { /* ignore */ }
-        const ext = magic.startsWith('\u0089PNG') ? '.png'
-          : magic.startsWith('\u00ff\u00d8\u00ff') ? '.jpg'
-          : magic.startsWith('GIF8') ? '.gif'
-            : (magic.slice(0, 4) === 'RIFF' && magic.slice(8, 12) === 'WEBP') ? '.webp'
-              : '';
-        if (!ext) return { ok: false, text: '', error: `无法识别图片格式（支持 png/jpeg/gif/webp）：${imagePath}` };
-        tempPath = join(tmpdir(), `dsh-vision-${randomUUID()}${ext}`);
-        try { writeFileSync(tempPath, readFileSync(imagePath)); } catch (error) {
-          return { ok: false, text: '', error: `暂存图片失败：${String(error && error.message)}` };
-        }
-        stagedPath = tempPath;
-      }
-
-      // ⑤a 首选 glance（skills/vision-tools 的本地视觉后端）
-      const askQuestion = args.ocr === true
-        ? '请逐字转写图里所有文字（保持原有换行与标点），不要解释。'
-        : (args.question ? String(args.question) : '请描述这张图片：整体内容、关键元素、图内可见文字。');
-      const cliArgs = [join(toolkit, 'bin', 'glance'), stagedPath];
-      if (args.ocr === true) cliArgs.push('--ocr');
-      else if (args.question) cliArgs.push('-q', String(args.question));
-
-      const runOnce = () => new Promise((resolveRun) => {
-        const child = spawn(python, cliArgs, {
-          cwd: toolkit,
-          env: { ...process.env, PYTHONPATH: scriptsDir },
-          windowsHide: true,
-        });
-        let out = '';
-        let err = '';
-        const timer = setTimeout(() => { try { child.kill(); } catch (error) { /* ignore */ } }, 280000);
-        child.stdout.on('data', (chunk) => { out += chunk.toString(); });
-        child.stderr.on('data', (chunk) => { err += chunk.toString(); });
-        child.on('error', (error) => { clearTimeout(timer); resolveRun({ code: -1, out, err: String(error && error.message) }); });
-        child.on('close', (code) => { clearTimeout(timer); resolveRun({ code, out, err }); });
-      });
-
-      // ⑤b 兜底后端：OpenAI 兼容的视觉 Chat API（2026-10-26：本机 vision-tools 的
-      // token-plan 后端全线 403 AccessDenied.Unpurchased，改用已验证接受图像输入的
-      // Ark DeepSeek V4.1 经济版；可用环境变量覆盖 base/model/key）。
-      const readArkKey = () => {
-        if (process.env.DSH_VISION_API_KEY) return process.env.DSH_VISION_API_KEY;
-        try {
-          const creds = readFileSync(join(homedir(), '.dsh', '.credentials.yaml'), 'utf8');
-          const m = /ARK_AGENT_PLAN_API_KEY:\s*['"]?([^'"\s]+)['"]?/.exec(creds);
-          if (m) return m[1];
-        } catch (error) { /* ignore */ }
-        return process.env.ARK_AGENT_PLAN_API_KEY || '';
-      };
-      const fallbackVision = async () => {
-        const key = readArkKey();
-        if (!key) return { ok: false, error: '没有可用的视觉 API key（DSH_VISION_API_KEY / ARK_AGENT_PLAN_API_KEY）' };
-        const base = String(process.env.DSH_VISION_BASE_URL || 'https://ark.cn-beijing.volces.com/api/plan/v3').replace(/\/+$/, '');
-        const model = String(process.env.DSH_VISION_MODEL || 'deepseek-v4-1-flash-economy-261017');
-        let b64 = '';
-        try { b64 = readFileSync(stagedPath).toString('base64'); } catch (error) {
-          return { ok: false, error: `读取图片失败：${String(error && error.message)}` };
-        }
-        const mime = /\.jpe?g$/i.test(stagedPath) ? 'image/jpeg'
-          : /\.gif$/i.test(stagedPath) ? 'image/gif'
-            : /\.webp$/i.test(stagedPath) ? 'image/webp' : 'image/png';
-        const body = JSON.stringify({
-          model,
-          max_tokens: 2048,
-          messages: [{
-            role: 'user',
-            content: [
-              { type: 'text', text: askQuestion },
-              { type: 'image_url', image_url: { url: `data:${mime};base64,${b64}` } },
-            ],
-          }],
-        });
-        try {
-          const res = await fetch(`${base}/chat/completions`, {
-            method: 'POST',
-            headers: { 'content-type': 'application/json', authorization: `Bearer ${key}` },
-            body,
-            signal: AbortSignal.timeout(180000),
-          });
-          const raw = await res.text();
-          if (res.status >= 400) return { ok: false, error: `HTTP ${res.status}: ${raw.slice(0, 400)}` };
-          const data = JSON.parse(raw);
-          const text = String((((data.choices || [])[0] || {}).message || {}).content || '').trim();
-          return text ? { ok: true, text: `${text}\n\n[via fallback vision model ${model}]` }
-            : { ok: false, error: `视觉后端返回空内容：${raw.slice(0, 300)}` };
-        } catch (error) {
-          return { ok: false, error: String(error && error.message) };
-        }
-      };
-
-      try {
-        const result = await runOnce();
-        const text = String(result.out || '').trim();
-        if (result.code === 0 && text) return { ok: true, text: text + visionModelNote };
-        const detail = String(result.err || '').trim() || text || `退出码 ${result.code}`;
-        // glance 后端失败 → 走兜底视觉模型（不把两段错误都抛给模型，只留摘要）
-        const fallback = await fallbackVision();
-        if (fallback.ok) return { ok: true, text: fallback.text + visionModelNote };
-        return {
-          ok: false,
-          text: '',
-          error: `glance 失败：${detail.slice(0, 500)}；兜底也失败：${String(fallback.error || '').slice(0, 500)}`,
-        };
-      } finally {
-        if (tempPath) { try { rmSync(tempPath, { force: true }); } catch (error) { /* ignore */ } }
-      }
-    },
-  }));
-
-  // —— routing_put ——
-  disposers.push(register({
-    name: 'routing_put',
-    description: '把用户消息归到任务线：合并写入 .hub/projects/<项目>/routing.json（原子写+自愈，不会覆盖已有条目）。'
-      + '代替手工 read+edit routing.json——归线一律走这里。'
-      + 'entries={"eventId":"taskId"} 逐条给；或 ids=[...] + lane="t7" 批量归同一条线。'
-      + 'taskId 取值：_none（过程消息）/ meeting（会议）/ t<数字>（任务线）。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['project'],
-      properties: {
-        project: { type: 'string', description: '项目名（.hub/projects/ 下的目录名）' },
-        entries: {
-          type: 'object',
-          description: '{ "<eventId>": "<taskId>" } 逐条映射；eventId 是 taskline_messages 返回的 eventId',
-          additionalProperties: { type: 'string' },
-        },
-        ids: { type: 'array', items: { type: 'string' }, description: '批量归同一条线时的事件 id 列表（与 lane 搭配）' },
-        lane: { type: 'string', description: '批量模式的目标 taskId（如 t7 / _none / meeting）' },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['ok'],
-        properties: {
-          ok: { type: 'boolean' },
-          written: { type: 'number' },
-          skipped: { type: 'array', items: { type: 'string' } },
-          total: { type: 'number' },
-          error: { type: 'string' },
-        },
-      },
-      render: (_args, value) => [{
-        type: 'text',
-        text: value.ok
-          ? `routing.json 已合并写入 ${value.written} 条（总 ${value.total} 条）${value.skipped && value.skipped.length ? `；跳过已存在/非法：${value.skipped.join('、')}` : ''}`
-          : `写入失败：${value.error || 'unknown'}`,
-      }],
-    },
-    async execute(args) {
-      try {
-        const project = String(args.project || '').trim().replace(/[\\/:*?"<>|]/g, '_');
-        if (!project) return { ok: false, error: 'project 不能为空' };
-        // 组装待写映射
-        const want = {};
-        const skipped = [];
-        // P12-①（2026-11-02）：原来只认 `t<数字>`，但星阶等项目用的是**语义 taskId**
-        // （status / stelscala-pm / week-plan-daily-exclude…），导致整批被 skipped
-        // → 「没有可写条目」。现改为：`_none`/`meeting` 直通 ∪ tasks.json 里的真实 id ∪ slug 兜底。
-        let knownTaskIds = new Set();
-        try {
-          const tasksFile = join(hostRoot(hub), '.hub', 'projects', project, 'tasks.json');
-          const tasksRaw = readJsonForWrite(tasksFile);
-          if (tasksRaw.ok && tasksRaw.value && Array.isArray(tasksRaw.value.tasks)) {
-            knownTaskIds = new Set(tasksRaw.value.tasks
-              .map((t) => (t && (t.id || t.taskId)) ? String(t.id || t.taskId) : '')
-              .filter(Boolean));
-          }
-        } catch { /* 读不到 tasks.json 就只靠 slug 兜底 */ }
-        const validLane = (v) => {
-          const lane = String(v || '');
-          if (lane === '_none' || lane === 'meeting') return true;
-          if (knownTaskIds.has(lane)) return true;
-          // slug 兜底：小写字母/数字开头，允许字母数字 _ - .（防手滑写成员名/中文进去）
-          return /^[a-z0-9][a-z0-9_.-]{0,63}$/i.test(lane);
-        };
-        if (args.entries && typeof args.entries === 'object' && !Array.isArray(args.entries)) {
-          for (const [id, lane] of Object.entries(args.entries)) {
-            if (!id || !validLane(lane)) { skipped.push(`${id}:${lane}`); continue; }
-            want[String(id)] = String(lane);
-          }
-        }
-        if (Array.isArray(args.ids) && args.ids.length) {
-          const lane = String(args.lane || '');
-          if (!validLane(lane)) return { ok: false, error: `lane 非法：${lane}（须 _none/meeting/t<数字>）` };
-          for (const id of args.ids) { if (id) want[String(id)] = lane; }
-        }
-        if (Object.keys(want).length === 0) {
-          const known = [...knownTaskIds].slice(0, 12).join(' / ') || '（tasks.json 无可用 id）';
-          return {
-            ok: false,
-            error: '没有可写条目。用法：entries={"<eventId>":"<taskId>"} 或 ids=[...]+lane="<taskId>"；'
-              + `taskId 可为 _none / meeting / 本项目 tasks.json 里的 id（如 ${known}）。`
-              + (skipped.length ? ` 被跳过的项：${skipped.slice(0, 5).join('、')}` : ''),
-            skipped,
-          };
-        }
-        const file = join(hostRoot(hub), '.hub', 'projects', project, 'routing.json');
-        // 写前自愈对账（2026-10-26 同款），再走「读→合并→原子写」，绝不整文件覆盖
-        guardRoutingFile(project, hostRoot(hub));
-        const read = readJsonForWrite(file);
-        if (!read.ok) return { ok: false, error: `routing.json 读取失败：${String(read.error)}` };
-        const routing = read.value || {};
-        let written = 0;
-        for (const [id, lane] of Object.entries(want)) {
-          if (routing[id]) { skipped.push(`${id}(已有)`); continue; }
-          routing[id] = lane;
-          written += 1;
-        }
-        if (written > 0) writeJsonAtomic(file, routing);
-        return { ok: true, written, skipped, total: Object.keys(routing).length };
-      } catch (error) {
-        return { ok: false, error: String((error && error.message) || error) };
-      }
-    },
-  }));
-
-  // —— taskline_messages ——
-  disposers.push(register({
-    name: 'taskline_messages',
-    description: '读取某个会话最近的消息，带 eventId（用于把用户消息归到具体任务线）。'
-      + '默认每条截 400 字；full=true 时截 4000 字（超长内容请让对方写文件给路径，别靠本工具全文搬运）。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session'],
-      properties: {
-        session: { type: 'string', description: 'sessionId 或标题片段' },
-        limit: { type: 'number', description: '返回最近多少条，默认 20' },
-        full: { type: 'boolean', description: 'true=每条最多 4000 字（默认 400 字截断）' },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['ok'],
-        properties: {
-          ok: { type: 'boolean' },
-          error: { type: 'string' },
-          // t38-A：三态外显（ok=有消息 / empty=会话真空 / unreadable=读不到）
-          state: { type: 'string' },
-          title: { type: 'string' },
-          diagnosis: { type: 'string' },
-          items: {
-            type: 'array',
-            items: {
-              type: 'object',
-              additionalProperties: false,
-              required: ['eventId', 'role', 'text'],
-              properties: {
-                eventId: { type: 'string' },
-                role: { type: 'string' },
-                time: { type: 'number' },
-                text: { type: 'string' },
-              },
-            },
-          },
-        },
-      },
-      render: (_args, value) => {
-        if (!value.ok) return [{ type: 'text', text: `读取失败：${value.error}` }];
-        if (!value.items || value.items.length === 0) {
-          // 三态可区分（t38-A，2026-11-10）：空会话 ≠ 读不到。以前两者都显示
-          //「这个会话没有消息」，导致把「读不到」误当「没消息」，归线随之断链。
-          if (value.state === 'empty') {
-            return [{ type: 'text', text: `（会话存在但确实还没有消息：${value.diagnosis || value.title || ''}）` }];
-          }
-          if (value.state === 'unreadable') {
-            return [{ type: 'text', text: `读取失败（读不到，不是空会话）：${value.diagnosis || value.error || '未知原因'}` }];
-          }
-          return [{ type: 'text', text: '（这个会话没有消息）' }];
-        }
-        return [{
-          type: 'text',
-          text: value.items
-            .map((item) => `${item.eventId}  ${item.role === 'user' ? '我' : 'agent'}  ${item.text}`)
-            .join('\n'),
-        }];
-      },
-    },
-    async execute(args) {
-      let session = deps.resolveSession(args.session);
-      if (!session) {
-        // t38-A（2026-11-10）：resolveSession 只查内存 sessions.list()，冷/僵尸会话会被判「找不到」。
-        // 若传的是完整 sessionId，就先当 id 直读持久日志（与 /sync/messages 同口径），
-        // 读得到就正常返回；读不到再明确回「读不到」而不是含糊的「找不到」。
-        const raw = String(args.session || '').trim();
-        if (/^session-[0-9a-f-]{16,}$/i.test(raw)) {
-          let probe = [];
-          try {
-            const read = await readSessionEvents(hub, raw);
-            probe = Array.isArray(read && read.events) ? read.events : [];
-          } catch { /* 下面按读不到处理 */ }
-          if (probe.length) {
-            session = { id: raw, title: raw, coldFallback: true, events: probe };
-          } else {
-            return {
-              ok: true,
-              items: [],
-              state: 'unreadable',
-              title: raw,
-              diagnosis: '该 sessionId 既不在内存会话列表，持久日志也读不到（壳可能已被换掉或日志已删）；'
-                + '请用 taskline_list 取当前 sessionId。',
-            };
-          }
-        } else {
-          return { ok: false, error: '找不到这个会话' };
-        }
-      }
-      const limit = Number.isFinite(args.limit) && args.limit > 0 ? Math.floor(args.limit) : 20;
-      // P6（2026-10-27 夜场）：默认截断 140→400 字；full=true 不截断（上限 4000 防爆）。
-      // 长回报的标准做法仍是「写临时文件 + 消息给路径」，full 只用于核对关键句。
-      const fullCap = 4000;
-      const clip = (t) => String(t)
-        .replace(/\s+/g, ' ')
-        .slice(0, args.full === true ? fullCap : 400);
-      // t38-A（2026-11-10 修「对部分会话恒返空/读不到」）：
-      // 旧实现只看 session.events（活会话）→ controller.inspect 的 data.message（活格式）。
-      // 冷会话（如日常·Yat2 停着的线、PrimCell·Yat2）恰恰是：①内存里没有 events；
-      // ②持久日志把回复存成 assistant/chunk 的 block-end/text-chunks，正文不在 data.message。
-      // 于是两条都落空 → 恒返「没有消息」。现改为走 hub-core 的 readSessionEvents（活+冷都读）
-      // + compactSessionEvents（把 chunk 形态重建成 assistant/message 正文），
-      // 并对「会话存在但真空」与「读不到」分别给出可判定状态。
-      const sid = session.id || (session && session.sessionId) || '';
-      let events = [];
-      let readError = '';
-      try {
-        const read = await readSessionEvents(hub, sid);
-        events = Array.isArray(read && read.events) ? read.events : [];
-      } catch (error) {
-        readError = String((error && error.message) || error);
-      }
-      if (events.length) {
-        try {
-          // compactSessionEvents 返回 { events, lastSeq, streaming }（不是数组，2026-11-10 实测）
-          const compacted = compactSessionEvents(events);
-          const rebuilt = Array.isArray(compacted) ? compacted
-            : (compacted && Array.isArray(compacted.events) ? compacted.events : []);
-          if (rebuilt.length) events = rebuilt;
-        } catch (error) {
-          console.warn(`[hub-desktop-ui] compactSessionEvents failed: ${String(error)}`);
-        }
-      }
-      const items = [];
-      for (const event of events) {
-        if (!event || (event.type !== 'user/message' && event.type !== 'assistant/message')) continue;
-        const data = event.data || {};
-        const message = data.message || data;
-        if (message && message.role === 'user') {
-          const source = message.source || {};
-          if (source.kind && source.kind !== 'user') continue;
-        }
-        const parts = Array.isArray(message.content) ? message.content : [];
-        const text = clip(parts
-          .filter((part) => part && part.type === 'text' && typeof part.text === 'string')
-          .map((part) => part.text)
-          .join('\n')
-          .trim());
-        if (!text) continue;
-        items.push({
-          eventId: String(event.id || event.key || event.seq || ''),
-          role: message.role === 'user' ? 'user' : 'agent',
-          time: Number(event.time || 0),
-          text,
-        });
-      }
-      // 三态判定（t38-A）：有消息 / 会话确实空 / 读不到。
-      if (items.length === 0) {
-        // 「读不到」判据：连一个事件都没拿到（不是拿到事件但都无正文）。
-        if (!events.length) {
-          return {
-            ok: true,
-            items: [],
-            state: 'unreadable',
-            title: (session && (session.title || session.name)) || '',
-            diagnosis: `会话在注册表可见，但事件池为空${readError ? `（读取异常：${readError}）` : ''}`
-              + '；可能是壳已换（旧 sessionId 残留）或持久日志未落盘。'
-              + '请用 taskline_list 取当前 sessionId 再试。',
-          };
-        }
-        return {
-          ok: true,
-          items: [],
-          state: 'empty',
-          title: (session && (session.title || session.name)) || '',
-          diagnosis: `读到 ${events.length} 个事件但无可展示正文`,
-        };
-      }
-      return { ok: true, items: items.slice(-limit), state: 'ok' };
-    },
-  }));
-
-  // —— taskline_archive ——
-  disposers.push(register({
-    name: 'taskline_archive',
-    description: '归档（或恢复）任务线：归档后从侧栏移除、群聊里进「已归档」，可恢复。'
-      + '**只用于一次性任务线 / 带「｜」分身**；常驻成员线（tasks.json 登记的正式成员）归档会被拒绝，'
-      + '确需换壳回收旧壳时显式传 force: true。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session'],
-      properties: {
-        session: { type: 'string', description: 'sessionId 或标题' },
-        restore: { type: 'boolean', description: 'true = 取消归档' },
-        force: { type: 'boolean', description: 'true = 强制归档常驻成员线（仅限换壳回收旧壳等明确场景）' },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['ok'],
-        properties: {
-          ok: { type: 'boolean' },
-          cleaned: { type: 'object' },
-          refused: { type: 'boolean' },
-          handoffPath: { type: 'string' },
-          handoffMessages: { type: 'number' },
-          error: { type: 'string' },
-        },
-      },
-      render: (_args, value) => [{
-        type: 'text',
-        text: !value.ok
-          ? `归档失败：${value.error}`
-          : `已完成归档操作${value.cleaned && value.cleaned.removedAvatar ? '；已清理该分身名的头像条目' : ''}`
-            + (value.cleaned && value.cleaned.removedFromMembers && value.cleaned.removedFromMembers.length
-              ? `；已从归档任务 ${value.cleaned.removedFromMembers.join(',')} 的 members 移除` : '')
-            + (value.handoffPath
-              ? `；交接档案已生成（${value.handoffMessages} 条 assistant 输出）：${value.handoffPath}`
-              : ''),
-      }],
-    },
-    async execute(args, exec) {
-      const registry = hub.get('workspaceRegistry');
-      const live = deps.resolveSession(args.session);
-      let sessionId = live && live.id;
-      let targetTitle = deps.titleOfSession(live) || '';
-      if (!sessionId) {
-        // 冷会话（重启后未激活）不在 sessions.list() 里：
-        // 用 sessionController.list() 兜底——id 精确匹配优先（同名新旧会话并存时按 id 无歧义）
-        try {
-          const controller = hub.get('sessionController');
-          const rows = controller && typeof controller.list === 'function'
-            ? await controller.list(new AbortController().signal) : [];
-          const arr = Array.isArray(rows) ? rows : (rows && Array.isArray(rows.items) ? rows.items : []);
-          const ref = String(args.session || '');
-          const byId = arr.find((r) => r && String(r.sessionId) === ref);
-          const byTitle = byId ? undefined : arr.find((r) => {
-            const t = r && r.projections && r.projections.values ? r.projections.values.title : '';
-            return typeof t === 'string' && t === ref;
-          });
-          const row = byId || byTitle;
-          if (row) {
-            sessionId = String(row.sessionId);
-            const pt = row && row.projections && row.projections.values ? row.projections.values.title : '';
-            if (!targetTitle && typeof pt === 'string') targetTitle = pt;
-          }
-        } catch (error) { /* 冷会话兜底失败 → 走原报错 */ }
-      }
-      if (!sessionId) return { ok: false, error: '找不到这个会话' };
-      if (!registry) return { ok: false, error: 'workspaceRegistry 不可用' };
-      // 2026-10-29 用户令「成员可自建分身并回收」——成员侧护栏：成员只能归档/恢复
-      // 「<本项目> · <本人父名>｜…」的分身；他人线 / 本体 / 常驻线一律拒（仍走管理者）。
-      // 管理者（Yat2/Hermes）与用户会话不受此限，原有常驻护栏继续生效。
-      {
-        const callerAgent = exec && exec.agent;
-        const callerTitle = callerAgent ? deps.callerTitleOf(callerAgent) : '';
-        if (callerTitle.includes(' · ') && !/ · (Yat2|Hermes)$/.test(callerTitle)) {
-          const callerProject = projectOfSessionTitle(callerTitle);
-          const callerRoleRaw = callerTitle.slice(callerTitle.lastIndexOf(' · ') + 3).trim();
-          const baseRole = callerRoleRaw.includes('｜')
-            ? callerRoleRaw.slice(0, callerRoleRaw.indexOf('｜')).trim() : callerRoleRaw;
-          const targetProject = projectOfSessionTitle(targetTitle);
-          const targetMember = agentNameOfTitle(targetTitle);
-          const isOwnClone = targetMember.includes('｜')
-            && targetMember.slice(0, targetMember.indexOf('｜')).trim() === baseRole
-            && targetProject === callerProject;
-          if (!isOwnClone) {
-            return {
-              ok: false,
-              error: `成员只能回收自己的分身（形如「${callerProject} · ${baseRole}｜…」）；`
-                + `「${targetTitle || sessionId}」不是你的分身。他人线/本体/常驻线请走管理者。`,
-            };
-          }
-        }
-      }
-      // 常驻成员护栏（2026-10-24「雨课堂被 Yat2 误归档」）：tasks.json 登记的正式成员线
-      // （无「｜」）默认拒绝归档——管理者只能归档一次性线/分身；确需换壳回收旧壳传 force。
-      if (!args.restore && args.force !== true) {
-        try {
-          const title = deps.titleOfSession(live) || '';
-          const registeredIds = readRegisteredSessionIds(hostRoot(hub));
-          if (registeredIds.has(String(sessionId)) && !title.includes('｜')) {
-            return {
-              ok: false,
-              refused: true,
-              error: `「${title || sessionId}」是 tasks.json 登记的常驻成员线，不做常规归档`
-                + '（做完回收只适用于一次性任务线 / 带「｜」的分身）。'
-                + '若确实要换壳回收旧壳，重试并显式传 force: true。',
-            };
-          }
-        } catch (error) { /* 护栏判定失败不挡归档 */ }
-      }
-      try {
-        if (args.restore) await registry.unarchiveSession(sessionId);
-        else {
-          await registry.archiveSession(sessionId, { stopActivity: true });
-          // 归档动作顺手触发清理（2026-10-24 用户令：不用定时器，超限删最旧）
-          await pruneArchivedSessions(hub).catch(() => {});
-        }
-      } catch (error) {
-        return { ok: false, error: String(error && error.message) };
-      }
-      // 归档分身时同步清理注册表（2026-10-22 用户要求）：
-      // 历次「成员｜具体任务」的分身名沉淀在 avatars 里，侧栏看起来像一堆细名本体。
-      let cleaned = null;
-      let handoff = null;
-      if (!args.restore) {
-        try {
-          const title = deps.titleOfSession(live) || '';
-          const project = projectOfSessionTitle(title);
-          const memberName = agentNameOfTitle(title);
-          if (project && memberName.includes('｜')) {
-            cleaned = cleanCloneRegistry(project, memberName, hostRoot(hub));
-            // 交接档案（2026-10-23）：分身归档后信息不能只埋在归档会话里，
-            // 机械抽取它的全部 assistant 输出落盘，供管理者/父 agent 事后 grep。
-            try {
-              // 2026-11-09 修「归档时 assistant 消息数=0，但答案其实已产出」：
-              // 实测 session-51e9dedd（「讲解已启用插件各自作用」）21:12:16 归档读到 0 条，
-              // 而它的 session.v4.jsonl.zstd 在 21:12:18 才落盘（263KB，内容齐全）——
-              // 归档动作早于持久化/内存 flush，于是交接档案空白。
-              // 修法：先读一次，若 0 条 assistant 就等 1.2s 重读（最多 2 次），
-              // 避免"回收早于产出"把分身成果丢掉。
-              let session = live || (hub.get('sessions') || {}).get?.(sessionId);
-              let events = await collectEvents(hub, session, sessionId);
-              const countAssistant = (list) => (Array.isArray(list) ? list : [])
-                .filter((e) => e && e.type === 'assistant/message').length;
-              for (let attempt = 0; attempt < 2 && countAssistant(events) === 0; attempt += 1) {
-                await new Promise((r) => setTimeout(r, 1200));
-                session = live || (hub.get('sessions') || {}).get?.(sessionId);
-                events = await collectEvents(hub, session, sessionId);
-                console.warn(`[hub-desktop-ui] clone handoff empty, retried (attempt ${attempt + 1}) session=${sessionId}`);
-              }
-              handoff = writeCloneHandoff(project, memberName, sessionId, title, events, hostRoot(hub));
-              if (!handoff.ok) {
-                console.warn(`[hub-desktop-ui] clone handoff failed: ${String(handoff.error)}`);
-              }
-            } catch (error) {
-              handoff = { ok: false, error: String((error && error.message) || error) };
-              console.warn(`[hub-desktop-ui] clone handoff threw: ${String(error)}`);
-            }
-          }
-        } catch (error) {
-          cleaned = { ok: false, error: String((error && error.message) || error) };
-        }
-      }
-      // 只在真的清理过（或明确失败）时才带 cleaned 字段——undefined 会让输出校验失败
-      const result = { ok: true };
-      if (cleaned && typeof cleaned === 'object') {
-        result.cleaned = {
-          removedAvatar: Boolean(cleaned.removedAvatar),
-          removedFromMembers: Array.isArray(cleaned.removedFromMembers) ? cleaned.removedFromMembers : [],
-          ...(cleaned.ok === false ? { error: String(cleaned.error || 'cleanup failed') } : {}),
-        };
-      }
-      if (handoff && handoff.ok && handoff.path) {
-        result.handoffPath = String(handoff.path);
-        result.handoffMessages = Number(handoff.assistantMessages) || 0;
-      }
-      return result;
-    },
-  }));
-
-  // —— taskline_rename ——
-  disposers.push(register({
-    name: 'taskline_rename',
-    description: '给任务线（会话）改标题，标题会直接显示在侧栏和群聊卡片上。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session', 'title'],
-      properties: {
-        session: { type: 'string', description: 'sessionId 或当前标题' },
-        title: { type: 'string', description: '新标题，建议「<项目> · <成员>」' },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['ok'],
-        properties: {
-          ok: { type: 'boolean' },
-          title: { type: 'string' },
-          error: { type: 'string' },
-        },
-      },
-      render: (_args, value) => [{ type: 'text', text: value.ok ? `已改名：${value.title}` : `改名失败：${value.error}` }],
-    },
-    async execute(args) {
-      const controller = hub.get('sessionController');
-      let session = deps.resolveSession(args.session);
-      // 冷会话回退（2026-10-27 修「找不到这个会话」）：deps.resolveSession 只查 sessions.list()
-      // （live 会话），冷/重启后会话不在其中。这里照 taskline_prompt 的做法查
-      // controller.list() 全量底册——精确 id 优先，其次精确标题（同对多个标题不猜，报歧义）。
-      if (!session && controller && typeof controller.list === 'function') {
-        try {
-          const value = await controller.list(new AbortController().signal);
-          const rows = value && Array.isArray(value.items) ? value.items : (Array.isArray(value) ? value : []);
-          const registry = hub.get('workspaceRegistry');
-          const archivedSet = new Set(
-            registry && Array.isArray(registry.archivedSessionIds)
-              ? registry.archivedSessionIds.map(String) : [],
-          );
-          const ref = String(args.session || '').trim();
-          const active = rows.filter((row) => row && row.sessionId
-            && !archivedSet.has(String(row.sessionId)));
-          const titleOf = (row) => (row.projections && row.projections.values
-            && typeof row.projections.values.title === 'string'
-            ? row.projections.values.title : '');
-          const byId = active.find((row) => String(row.sessionId) === ref);
-          if (byId) {
-            session = { id: String(byId.sessionId), displayTitle: titleOf(byId) };
-          } else {
-            const byTitle = active.filter((row) => titleOf(row) === ref);
-            if (byTitle.length === 1) {
-              session = { id: String(byTitle[0].sessionId), displayTitle: titleOf(byTitle[0]) };
-            } else if (byTitle.length > 1) {
-              return { ok: false, error: `同名多个会话：${byTitle.map((r) => `${titleOf(r)} ${r.sessionId}`).join('；')}（请传完整 sessionId）` };
-            }
-          }
-        } catch { /* 回退失败走原错误 */ }
-      }
-      if (!session) return { ok: false, error: '找不到这个会话（冷会话请传完整 sessionId，用 taskline_list 查）' };
-      try {
-        await controller.rename({ sessionId: session.id, title: args.title });
-        // 改完立刻对账：若与新标题撞名的另一条还在活跃集合里，把非官方那条改「（旧壳 MM-DD）」
-        dedupeActiveTitles(hub).catch(() => {});
-        return { ok: true, title: args.title };
-      } catch (error) {
-        return { ok: false, error: String(error && error.message) };
-      }
-    },
-  }));
-
-  // —— resume_session ——
-  disposers.push(register({
-    name: 'resume_session',
-    description: '让指定会话从断点续跑（发一条【续跑】提示，绕过 24h 自动续跑账本）。用于重启后没被自动续跑、或需要强制推进的会话。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session'],
-      properties: {
-        session: { type: 'string', description: '目标会话的 sessionId 或标题（可部分匹配）' },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['ok'],
-        properties: { ok: { type: 'boolean' }, resumed: { type: 'array', items: { type: 'string' } }, error: { type: 'string' } },
-      },
-      render: (_args, value) => [{
-        type: 'text',
-        text: value.ok
-          ? `已续跑 ${value.resumed.length} 个会话：${value.resumed.join('、') || '（无匹配）'}`
-          : `续跑失败：${value.error || 'unknown'}`,
-      }],
-    },
-    async execute(args) {
-      try {
-        const result = await resumeInterruptedSessions(hub, { force: true, only: String(args.session || ''), max: 1 });
-        return { ok: true, resumed: result.resumed };
-      } catch (error) {
-        return { ok: false, error: String(error && error.message) };
-      }
-    },
-  }));
-
-  // —— taskline_goal_status ——
-  disposers.push(register({
-    name: 'taskline_goal_status',
-    description: '查某个会话当前的 goal（标题 / 状态 / 轮次）。派活带 goal 后用它核验是否真的建进会话。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session'],
-      properties: {
-        session: { type: 'string', description: '目标会话的 sessionId 或标题（可部分匹配）' },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['ok'],
-        properties: {
-          ok: { type: 'boolean' },
-          sessionId: { type: 'string' },
-          title: { type: 'string' },
-          hasGoal: { type: 'boolean' },
-          objective: { type: 'string' },
-          phase: { type: 'string' },
-          roundsStarted: { type: 'number' },
-          maxGoalRounds: { type: 'number' },
-          goalId: { type: 'string' },
-          error: { type: 'string' },
-        },
-      },
-      render: (_args, value) => [{
-        type: 'text',
-        text: !value.ok
-          ? `查询失败：${value.error || 'unknown'}`
-          : value.hasGoal
-            ? `「${value.title || value.sessionId}」goal=[${value.phase}] ${value.objective}（轮次 ${value.roundsStarted}/${value.maxGoalRounds}）`
-            : `「${value.title || value.sessionId}」当前没有 goal`,
-      }],
-    },
-    async execute(args) {
-      const ref = String(args.session || '').trim();
-      const isExactId = /^session-[0-9a-f-]{20,}$/i.test(ref);
-      let session = isExactId ? (hub.get('sessions') && hub.get('sessions').get(ref)) : deps.resolveSession(ref);
-      if (!session && isExactId) session = { id: ref };
-      if (!session) return { ok: false, error: '找不到这个会话' };
-      const goalsSvc = hub.get('goals') || (typeof ctx.get === 'function' ? ctx.get('goals') : undefined);
-      const agentsSvc = hub.get('agents');
-      const agent = agentsSvc && typeof agentsSvc.get === 'function' ? agentsSvc.get(String(session.id)) : undefined;
-      if (!goalsSvc || typeof goalsSvc.get !== 'function') return { ok: false, error: 'goal 服务（ctx.goals）不可用' };
-      if (!agent || !agent.session) return { ok: false, sessionId: String(session.id), title: deps.titleOfSession(session), hasGoal: false, error: 'agent 未激活（冷会话需先唤醒）' };
-      try {
-        const view = goalsSvc.get(agent);
-        const goal = view && (view.goal || view);
-        if (!goal || !goal.id) {
-          return { ok: true, sessionId: String(session.id), title: deps.titleOfSession(session), hasGoal: false, error: '' };
-        }
-        return {
-          ok: true,
-          sessionId: String(session.id),
-          title: deps.titleOfSession(session),
-          hasGoal: true,
-          goalId: String(goal.id || ''),
-          objective: String(goal.objective || ''),
-          phase: String(goal.phase || ''),
-          roundsStarted: Number(goal.roundsStarted) || 0,
-          maxGoalRounds: Number(goal.maxGoalRounds) || 0,
-          error: '',
-        };
-      } catch (error) {
-        return { ok: false, sessionId: String(session.id), error: String((error && error.message) || error) };
-      }
-    },
-  }));
-
-  // —— taskline_wait ——
-  disposers.push(register({
-    name: 'taskline_wait',
-    description: '例外工具（默认派完即转下一任务，不等成员）：仅当用户要当场闭环结论时才用。'
-      + '等成员状态变化（不轮询）：运行中→空闲或有新消息就返回；没有目标在跑立刻 noProgress。timeoutMs 建议 ≤60000。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: [],
-      properties: {
-        session: { type: 'string', description: '单个目标：sessionId 或标题（可部分匹配）' },
-        sessionIds: {
-          type: 'array',
-          items: { type: 'string' },
-          description: '多个目标：sessionId 或标题片段。session 与 sessionIds 都不给 = 等任意成员（除调用者自己）',
-        },
-        timeoutMs: { type: 'number', description: '最长等待毫秒，默认 120000，上限 600000' },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['status', 'waitedMs'],
-        properties: {
-          status: { type: 'string', enum: ['changed', 'noProgress', 'timeout'] },
-          waitedMs: { type: 'number' },
-          changed: {
-            type: 'array',
-            items: {
-              type: 'object',
-              additionalProperties: false,
-              required: ['sessionId', 'title', 'idle'],
-              properties: {
-                sessionId: { type: 'string' },
-                title: { type: 'string' },
-                idle: { type: 'boolean' },
-              },
-            },
-          },
-          error: { type: 'string' },
-        },
-      },
-      render: (_args, value) => {
-        if (value.status === 'changed') {
-          const list = (value.changed || [])
-            .map((item) => `${item.title || item.sessionId}${item.idle ? ' [已空闲]' : ' [有新消息]'}`)
-            .join('、');
-          return [{ type: 'text', text: `成员状态有变化（等了 ${value.waitedMs}ms）：${list || '（无）'}` }];
-        }
-        if (value.status === 'noProgress') {
-          return [{ type: 'text', text: `没有目标在运行，立刻返回 noProgress（${value.waitedMs}ms）${value.error ? `\n${value.error}` : ''}` }];
-        }
-        return [{ type: 'text', text: `等待超时（${value.waitedMs}ms）：目标仍无变化${value.error ? `\n${value.error}` : ''}` }];
-      },
-    },
-    async execute(args, exec) {
-      const startedAt = Date.now();
-      const sessionsSvc = hub.get('sessions');
-      const liveList = sessionsSvc && typeof sessionsSvc.list === 'function' ? sessionsSvc.list() : [];
-      const callerId = exec && exec.agent && exec.agent.id !== undefined ? String(exec.agent.id) : '';
-      const registry = hub.get('workspaceRegistry');
-      const archivedSet = new Set(
-        registry && Array.isArray(registry.archivedSessionIds) ? registry.archivedSessionIds.map(String) : [],
-      );
-      const titleOfId = (id) => {
-        const live = liveList.find((session) => String(session.id) === String(id));
-        return live ? deps.titleOfSession(live) : '';
-      };
-      // 解析目标：显式 ref 优先，都不给 = 任意成员（排除调用者自己——它正在跑本次调用）
-      const refs = [];
-      if (args.session) refs.push(String(args.session).trim());
-      if (Array.isArray(args.sessionIds)) {
-        for (const ref of args.sessionIds) {
-          const text = String(ref || '').trim();
-          if (text) refs.push(text);
-        }
-      }
-      const targetIds = new Set();
-      const unknown = [];
-      if (refs.length === 0) {
-        for (const session of liveList) {
-          const id = String(session.id);
-          if (id === callerId || archivedSet.has(id)) continue;
-          targetIds.add(id);
-        }
-      } else {
-        for (const ref of refs) {
-          if (/^session-[0-9a-f-]{20,}$/i.test(ref)) {
-            targetIds.add(ref);
-            continue;
-          }
-          const hits = liveList.filter((session) => {
-            const title = deps.titleOfSession(session);
-            return title === ref || title.includes(ref);
-          });
-          if (hits.length === 0) unknown.push(ref);
-          else for (const session of hits) targetIds.add(String(session.id));
-        }
-      }
-      const unknownNote = unknown.length ? `找不到会话：${unknown.join(' / ')}` : '';
-      if (targetIds.size === 0) {
-        return { status: 'noProgress', waitedMs: Date.now() - startedAt, ...(unknownNote ? { error: unknownNote } : {}) };
-      }
-      // 没有目标在跑 → 不等待，立刻返回（验收 a）
-      const runningIds = [...targetIds].filter((id) => deps.isRunningNow(id));
-      if (runningIds.length === 0) {
-        return { status: 'noProgress', waitedMs: Date.now() - startedAt, ...(unknownNote ? { error: unknownNote } : {}) };
-      }
-      const requested = Number(args.timeoutMs);
-      const timeoutMs = Number.isFinite(requested) && requested > 0
-        ? Math.min(Math.max(Math.floor(requested), 1000), 600000)
-        : 120000;
-
-      const outcome = await new Promise((finishWait) => {
-        let settled = false;
-        let offStatus;
-        let offSession;
-        let timer;
-        const idleChanged = () => [...targetIds]
-          .filter((id) => !deps.isRunningNow(id))
-          .map((id) => ({ sessionId: id, title: titleOfId(id), idle: true }));
-        const cleanup = () => {
-          if (timer) clearTimeout(timer);
-          for (const off of [offStatus, offSession]) {
-            if (typeof off === 'function') {
-              try { off(); } catch (error) { /* ignore */ }
-            }
-          }
-        };
-        const settle = (value) => {
-          if (settled) return;
-          settled = true;
-          cleanup();
-          finishWait({ ...value, waitedMs: Date.now() - startedAt });
-        };
-        timer = setTimeout(() => settle({ status: 'timeout' }), timeoutMs);
-        if (timer && typeof timer.unref === 'function') timer.unref();
-        // 1) 官方运行状态事件：目标 running → false 即返回
-        offStatus = hub.on('api-session/status', (changedId, running) => {
-          try {
-            const key = String(changedId);
-            if (!targetIds.has(key) || running) return;
-            settle({ status: 'changed', changed: idleChanged() });
-          } catch (error) { /* ignore */ }
-        });
-        // 2) 会话事件：回合结束（且确实空闲）或新用户消息也算「有变化」
-        offSession = hub.on('session/event', (session, event) => {
-          try {
-            const key = session && session.id !== undefined ? String(session.id) : '';
-            if (!targetIds.has(key) || !event) return;
-            const type = String(event.type || '');
-            const sourceKind = event.data && event.data.source ? event.data.source.kind : undefined;
-            const freshUserMessage = type === 'user/message'
-              && (!sourceKind || sourceKind === 'user');
-            if (type !== 'turn/end' && !freshUserMessage) return;
-            const idle = idleChanged();
-            if (idle.length > 0) {
-              settle({ status: 'changed', changed: idle });
-              return;
-            }
-            if (freshUserMessage) {
-              settle({ status: 'changed', changed: [{ sessionId: key, title: titleOfId(key), idle: false }] });
-            }
-          } catch (error) { /* ignore */ }
-        });
-        // 3) 调用方取消（用户点停止）：不悬挂，清理监听后按取消返回
-        const signal = exec && exec.signal;
-        if (signal && typeof signal.addEventListener === 'function') {
-          if (signal.aborted) {
-            settle({ status: 'timeout', error: 'aborted' });
-            return;
-          }
-          signal.addEventListener('abort', () => settle({ status: 'timeout', error: 'aborted' }), { once: true });
-        }
-        // 4) 竞态兜底：目标可能在「检查 running」与「挂监听」之间就已经变 idle，
-        //    挂完监听再读一次真实状态，别白等到超时。
-        const alreadyIdle = idleChanged();
-        if (alreadyIdle.length > 0) settle({ status: 'changed', changed: alreadyIdle });
-      });
-      return unknownNote ? { ...outcome, error: outcome.error || unknownNote } : outcome;
-    },
-  }));
-
-  // —— taskline_create ——
-  disposers.push(register({
-    name: 'taskline_create',
-    description: '新建一条任务线：创建一个新会话并命名（可选立刻给它派第一条任务）。\n'
-      + '**任务书里必须带「用户可见验收」段**（§20，2026-11-10 用户令）：'
-      + '写清用户能**直接看/点/复制**的验收物——截图、可打开的文件或 URL、一段可粘贴的输出——'
-      + '而不是「测试通过 / 已自测」这类自证。模板：\n'
-      + '【验收（用户可见）】①<可打开的产物路径或 URL>；②<用户一条命令能复现的输出>；'
-      + '③<若涉及重启，写清重启后一步核验的方法>。\n'
-      + '**不写自证式验收（"单测通过""逻辑正确"）**：验收物必须由用户侧可见，审核者据此判定完成。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['title'],
-      properties: {
-        title: { type: 'string', description: '新任务线标题，建议「<项目> · <成员>」' },
-        text: {
-          type: 'string',
-          description: '可选的初始任务内容。**必须含「【验收（用户可见）】」段**：'
-            + '列出用户可直接看/点/复制的验收物（产物路径或 URL、可复现命令与输出、重启后一步核验法），'
-            + '禁止只写「测试通过」「已自测」等自证。',
-        },
-        preset: { type: 'string', description: '可选的 agent preset，默认 cordis（Creator mode）' },
-        project: { type: 'string', description: '所属项目名，默认从 title 的「 · 」前解析' },
-        avatar: { type: 'string', description: '头像 emoji，可不填（自动从候选池分配一个未被占用的）' },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['ok'],
-        properties: {
-          ok: { type: 'boolean' },
-          sessionId: { type: 'string' },
-          title: { type: 'string' },
-          avatar: { type: 'string' },
-          warning: { type: 'string' },
-          error: { type: 'string' },
-        },
-      },
-      render: (_args, value) => [{
-        type: 'text',
-        text: value.ok
-          ? `已建任务线：${value.title}（${value.sessionId}）${value.warning ? `\n⚠️ ${value.warning}` : ''}`
-          : `新建失败：${value.error}`,
-      }],
-    },
-    async execute(args, exec) {
-      // 2026-10-29 用户令「每个 agent 多线任务时可自建分身并回收」——成员侧护栏：
-      // 成员（标题「项目 · 角色」且非管理者）只能建「<本项目> · <本人父名>｜<任务短语>」
-      // 的分身；裸名本体 / 别人的分身 / 跨项目一律拒，仍走管理者。管理者/用户会话不受限。
-      const callerAgent = exec && exec.agent;
-      const callerTitle = callerAgent ? deps.callerTitleOf(callerAgent) : '';
-      if (callerTitle.includes(' · ') && !/ · (Yat2|Hermes)$/.test(callerTitle)) {
-        const callerProject = projectOfSessionTitle(callerTitle);
-        const callerRoleRaw = callerTitle.slice(callerTitle.lastIndexOf(' · ') + 3).trim();
-        // 分身再开子分身时按父名认亲（「DSH工程师｜a」开的也必须是「DSH工程师｜…」）
-        const baseRole = callerRoleRaw.includes('｜')
-          ? callerRoleRaw.slice(0, callerRoleRaw.indexOf('｜')).trim() : callerRoleRaw;
-        const wantMember = args.title.includes(' · ')
-          ? args.title.slice(args.title.lastIndexOf(' · ') + 3).trim() : args.title.trim();
-        const wantProject = args.project || (args.title.includes(' · ')
-          ? args.title.slice(0, args.title.indexOf(' · ')).trim() : callerProject);
-        const wantParent = wantMember.includes('｜')
-          ? wantMember.slice(0, wantMember.indexOf('｜')).trim() : '';
-        if (!wantMember.includes('｜') || wantParent !== baseRole || wantProject !== callerProject) {
-          return {
-            ok: false,
-            error: `成员只能自建分身：标题形如「${callerProject} · ${baseRole}｜<任务短语>」`
-              + `（父名必须是本人、项目必须是本项目）。建本体 / 他人分身 / 跨项目仍需管理者。`,
-          };
-        }
-      }
-      const controller = hub.get('sessionController');
-      if (!controller || typeof controller.create !== 'function') return { ok: false, error: 'sessionController 不可用' };
-      try {
-        // 命名校验前置（2026-10-23 用户令；2026-10-26 三改）：必须发生在 controller.create **之前**，
-        // 否则违规名被拒时会话已建出来，留孤儿。
-        // 2026-10-26 用户新规则——校验分两路：
-        //   A. 带「｜」→ **分身**路：形如「<父名>｜<任务短语>」（如 DSH工程师｜切换提速）。
-        //      父名须是本项目已存在的成员；任务短语非空即过（2 字以上更佳但不强制）；
-        //      「｜副手/｜二号」不再特殊，也是合法分身名；**无数量上限，完成即归档回收**。
-        //   B. 不带「｜」→ **本体**路：旧规则全保留——拒裸宽泛词（工程师/专家/管家…），
-        //      任务型名字给警告不拒绝。
-        const memberName = args.title.includes(' · ') ? args.title.slice(args.title.lastIndexOf(' · ') + 3).trim() : args.title.trim();
-        const projectNameEarly = args.project || (args.title.includes(' · ') ? args.title.slice(0, args.title.indexOf(' · ')).trim() : '');
-        const BARE_ROLE_WORDS = ['工程师', '专家', '管家', '助手', '成员', '分析师', '设计师', '研究员', 'agent', 'Agent'];
-        let nameWarning = '';
-        if (memberName.includes('｜')) {
-          const barAt = memberName.indexOf('｜');
-          const parentName = memberName.slice(0, barAt).trim();
-          const taskPhrase = memberName.slice(barAt + 1).trim();
-          if (!parentName) {
-            return { ok: false, error: `「${memberName}」缺父名——分身名形如「<父名>｜<任务短语>」（如 DSH工程师｜切换提速）` };
-          }
-          if (!taskPhrase) {
-            return { ok: false, error: `「${memberName}」缺任务短语——分身名形如「<父名>｜<任务短语>」（如 DSH工程师｜切换提速）` };
-          }
-          // 父名须是本项目已存在的成员（防拼错父名造出野分身）
-          if (projectNameEarly) {
-            const row = readTaskFile(projectNameEarly, hostRoot(hub));
-            const raw = row && row.tasks && typeof row.tasks === 'object' && !Array.isArray(row.tasks) ? row.tasks : {};
-            const tasksList = Array.isArray(raw.tasks) ? raw.tasks : [];
-            const sessionsMap = raw.memberSessions && typeof raw.memberSessions === 'object' ? raw.memberSessions : {};
-            const known = new Set(Object.keys(sessionsMap));
-            for (const task of tasksList) {
-              for (const name of (Array.isArray(task && task.members) ? task.members : [])) known.add(String(name));
-            }
-            if (known.size > 0 && !known.has(parentName)) {
-              return {
-                ok: false,
-                error: `分身父名「${parentName}」不是项目「${projectNameEarly}」的已登记成员（候选：${[...known].slice(0, 8).join(' / ')}）——先有本体成员，再挂分身`,
-              };
-            }
-            // 2026-11-09 用户令（父名错第二次）：分诊建线时父名必须是**被分诊线的成员**，
-            // 不是分诊者自己。分诊者通常是管理者 Yat2 → 会建出「Yat2｜<UI 开发任务>」，
-            // 让管理者名下堆交付物线（违反「管理者不产出交付物」）。工具层直接拦。
-            if (parentName === 'Yat2' && known.size > 1) {
-              const executors = [...known].filter((x) => x !== 'Yat2');
-              return {
-                ok: false,
-                error: `父名不能用管理者「Yat2」——这条线该由真实执行成员挂：${executors.slice(0, 6).join(' / ')}`
-                  + '（用户令 2026-11-09：分诊建的线父名必须是**被分诊线的成员**，不是分诊者自己；管理者不产出交付物）',
-              };
-            }
-          }
-          // 分身名 = 任务短语，天然任务导向，不再触发 looksTaskSpecificName 警告
-        } else {
-          if (BARE_ROLE_WORDS.includes(memberName)) {
-            return {
-              ok: false,
-              error: `「${memberName}」是裸宽泛角色名，禁止使用——请带领域前缀（如 DSH工程师 / 视网膜专家 / 出题工程师）`,
-            };
-          }
-          if (looksTaskSpecificName(memberName)) {
-            nameWarning = `「${memberName}」像是具体任务名——常驻本体建议起正式角色名（职责导向）；**按任务开线请用分身**：「<父名>｜<任务短语>」（完成即归档回收）`;
-          }
-        }
-        const created = await controller.create({ cwd: hostRoot(hub), agentPreset: args.preset || defaultPreset });
-        const sessionId = created && created.sessionId;
-        if (!sessionId) return { ok: false, error: '创建未返回 sessionId' };
-        await controller.rename({ sessionId, title: args.title });
-        const projectName = projectNameEarly;
-        const assignedAvatar = projectName ? ensureMemberAvatar(projectName, memberName, hostRoot(hub), args.avatar) : '';
-        // 2026-10-26：头像登记失败不再静默——告诉 Yat2 当场补（韩明明论文·论文写手
-        // 漏头像就是写错根 + 静默失败叠加的结果，排查靠人眼）
-        const avatarWarning = projectName && !assignedAvatar
-          ? `头像未登记（${projectName}/tasks.json 或全局 avatars.json 写入失败）——建完后请检查并手工补 .hub/avatars.json`
-          : '';
-        if (args.text) {
-          await controller.prompt({
-            requestId: `hub-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
-            sessionId,
-            mode: 'queue',
-            content: [{ type: 'text', text: args.text }],
-          }, new AbortController().signal);
-        }
-        return {
-          ok: true, sessionId, title: args.title,
-          // 2026-10-29：lossless JSON 不认 undefined 值（头像池空时报 invalid output）——改为条件展开
-          ...(assignedAvatar ? { avatar: assignedAvatar } : {}),
-          ...(([nameWarning, avatarWarning].filter(Boolean).join('；')) ? { warning: [nameWarning, avatarWarning].filter(Boolean).join('；') } : {}),
-        };
-      } catch (error) {
-        return { ok: false, error: String(error && error.message) };
-      }
-    },
-  }));
-
-  // —— taskline_prompt ——
-  disposers.push(register({
-    name: 'taskline_prompt',
-    description: '给指定的任务线（会话）派活：按 sessionId 或会话标题找到它，发一条消息。用于分派、催办、重启任务线。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session', 'text'],
-      properties: {
-        session: { type: 'string', description: '目标会话的 sessionId 或标题（可部分匹配）' },
-        text: {
-          type: 'string',
-          description: '要发给它的话，写清任务与验收标准。'
-            + '**验收必须是「用户可见验收」**（§20）：给出用户能直接看/点/复制的验收物'
-            + '（产物路径或 URL、可复现命令及输出、重启后一步核验法），'
-            + '不要写「测试通过」「已自测」这类自证；模板见 taskline_create。',
-        },
-        goal: {
-          type: 'string',
-          description: '本线目标（一句话、交付物导向）。传了会写进 tasks.json 的 goal 并把目标化指令插到 prompt 最前面；不传保持原行为',
-        },
-        task: {
-          type: 'string',
-          description: '任务线 id（如 client-ui / quota-panel）。同一成员属于多条线时必须传，否则写 goal 会因歧义被拒绝并返回候选列表',
-        },
-        mode: {
-          type: 'string',
-          enum: ['triage', 'queue', 'steer', 'interrupt'],
-          description: '投递方式，默认 triage（2026-11-08 用户令：排队不再干等）。'
-            + 'triage = 目标在跑时**不排队**，立刻开一条「<成员>｜queue分诊」分身：它读主线上下文后判定'
-            + '「纠偏/补充/紧急 → steer 进主线当前轮」还是「独立新任务 → 分身自己做」，给出交接摘要后插件自动归档回收；'
-            + '目标空闲时退化为 queue（直接起一轮，不开分身）；'
-            + 'queue = 老行为，真排队等它跑完当前轮（仅当你明确要「等它跑完」时用）；'
-            + 'steer = 目标在跑时在下一个 step 边界把消息插进当前轮（不打断正在执行的工具调用），目标空闲时自动退化为 queue；'
-            + 'interrupt = 中断目标当前这一轮但保留已排队的后续消息（本条排进队列，等下次唤醒按序处理）',
-        },
-        timeoutMs: {
-          type: 'number',
-          description: `仅 interrupt 用：等目标变 idle 的上限毫秒，默认 ${INTERRUPT_IDLE_WAIT_MS}。`
-            + 'abort 慢于该值时返回 idle:false，但 interrupted:true 且已排队消息已保留（按 interrupted 判定中断成功即可）',
-        },
-      },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['ok'],
-        properties: {
-          ok: { type: 'boolean' },
-          sessionId: { type: 'string' },
-          title: { type: 'string' },
-          goal: { type: 'string' },
-          goalTaskId: { type: 'string' },
-          goalError: { type: 'string' },
-          goalWritten: { type: 'boolean' },
-          goalCreated: { type: 'boolean' },
-          goalFailed: { type: 'string' },
-          goalMatchedBy: { type: 'string' },
-          candidates: { type: 'array', items: { type: 'string' } },
-          crossProject: { type: 'boolean' },
-          callerProject: { type: 'string' },
-          targetProject: { type: 'string' },
-          mode: { type: 'string' },
-          interrupted: { type: 'boolean' },
-          idle: { type: 'boolean' },
-          textQueued: { type: 'boolean' },
-          // 派活纪律（2026-10-26）：目标运行状态与排队位次（工具层强制回传）
-          targetRunning: { type: 'boolean' },
-          pendingDispatches: { type: 'number' },
-          queuedBefore: { type: 'number' },
-          // queue 分诊（2026-11-08）：不排队，改开分诊分身
-          triageSessionId: { type: 'string' },
-          triageTitle: { type: 'string' },
-          // 唯一投递结论（2026-11-09）：triage / steer / queued / interrupted / started
-          delivery: { type: 'string' },
-          note: { type: 'string' },
-          error: { type: 'string' },
-        },
-      },
-      // 2026-11-09：render 抽成纯函数（同一返回只允许一个结论；回归用例直接断言它）
-      render: (_args, value) => [{ type: 'text', text: renderTasklinePrompt(value) }],
-    },
-    async execute(args, exec) {
-      const controller = hub.get('sessionController');
-      if (!controller || typeof controller.prompt !== 'function') return { ok: false, error: 'sessionController 不可用' };
-      // P8-①（2026-10-29）：text 缺失/非字符串时**拒绝投递**并报错——此前 args.text 为
-      // undefined 会拼出字面 "undefined" 空消息投给成员（骨髓·单细胞师/生信分析师 10-29
-      // 16:52、16:55 各两连发）。宁可报错重发，不可投递垃圾轮。
-      if (typeof args.text !== 'string' || !args.text.trim()) {
-        return {
-          ok: false,
-          error: '缺少 text（收到 undefined/空/非字符串）。请检查 taskline_prompt 调用参数后重发；本条未投递。',
-        };
-      }
-      const ref = String(args.session || '').trim();
-      const isExactId = /^session-[0-9a-f-]{20,}$/i.test(ref);
-      let session = deps.resolveSession(ref);
-      // —— 同名歧义防护（重建后旧壳陷阱，DSH sync工程师 案例）——
-      // 标题寻址时：只有「唯一 live 命中，且不存在其它同名（冷/归档）」才直接投；
-      // 否则不静默投递，列出全部候选（id 尾 8 位 + 状态）让管理者用完整 sessionId 指定。
-      if (!isExactId) {
-        const liveSvc = hub.get('sessions');
-        const liveAll = liveSvc && typeof liveSvc.list === 'function' ? liveSvc.list() : [];
-        const liveHits = liveAll.filter((s) => {
-          const t = deps.titleOfSession(s);
-          return t === ref || t.includes(ref);
-        });
-        const registry = hub.get('workspaceRegistry');
-        const archivedSet = new Set(
-          registry && Array.isArray(registry.archivedSessionIds) ? registry.archivedSessionIds.map(String) : [],
-        );
-        const candidates = liveHits.map((s) => ({
-          id: String(s.id),
-          title: deps.titleOfSession(s),
-          state: archivedSet.has(String(s.id)) ? 'archived' : 'live',
-        }));
-        const seen = new Set(candidates.map((c) => c.id));
-        // 冷/归档同名候选也纳入清点（controller.list 是全量底册）
-        try {
-          const rows = await controller.list(new AbortController().signal);
-          const arr = Array.isArray(rows) ? rows : (rows && Array.isArray(rows.items) ? rows.items : []);
-          for (const row of arr) {
-            if (!row || !row.sessionId) continue;
-            const id = String(row.sessionId);
-            const t = row.projections && row.projections.values && typeof row.projections.values.title === 'string'
-              ? row.projections.values.title : '';
-            if (!t || !t.includes(ref)) continue;
-            if (seen.has(id)) continue;
-            seen.add(id);
-            candidates.push({ id, title: t, state: archivedSet.has(id) ? 'archived' : 'cold' });
-          }
-        } catch { /* 底册列不全就只按 live 候选判 */ }
-        if (candidates.length !== 1) {
-          return {
-            ok: false,
-            error: `「${ref}」命中 ${candidates.length} 个会话（${candidates.length === 0
-              ? '一个都没找到'
-              : candidates.map((c) => `${c.title} ${c.id} [${c.state}]`).join(' ; ')}）——`
-              + `会话重建后旧壳可能还在，请用 taskline_list 确认后传完整 sessionId 投递`,
-          };
-        }
-        session = liveHits[0];
-      }
-      if (!session) {
-        // 冷会话兜底：resolveAgent 会把它 resume 成活会话
-        //（SessionController.prompt 内部对 sessionId 走的就是 resolveAgent 同一条路）。
-        const agentsCtl = controller.agents;
-        if (agentsCtl && typeof agentsCtl.resolveAgent === 'function') {
-          try {
-            const found = await agentsCtl.resolveAgent(String(args.session));
-            if (found && found.agent) {
-              const resumedId = found.agent.session && found.agent.session.id ? found.agent.session.id : String(args.session);
-              const live = hub.get('sessions');
-              session = (live && typeof live.get === 'function' ? live.get(resumedId) : undefined)
-                || { id: resumedId };
-              console.log(`[hub-desktop-ui] taskline_prompt resumed cold session ${resumedId}`);
-            }
-          } catch (error) {
-            console.warn(`[hub-desktop-ui] cold resume failed: ${String(error)}`);
-          }
-        }
-      }
-      if (!session) return { ok: false, error: '找不到这个会话（先用 taskline_list 看 id；冷会话要传完整 sessionId）' };
-      // —— 项目边界护栏（2026-10-22 用户规则）——
-      // 每个项目的 agent 只能给本项目成员派活；跨项目直派会让群聊/侧栏出现
-      // 本项目看不见的成员（Book 的 Yat2 直派「应用开发 · DSH工程师」案例）。
-      // 工具层硬拒，不依赖管理者记住协议。exec.agent = 调用方（tools 服务注入）。
-      try {
-        const callerAgent = exec && exec.agent;
-        const callerTitle = callerAgent ? deps.callerTitleOf(callerAgent) : '';
-        const callerProject = projectOfSessionTitle(callerTitle);
-        const targetProject = projectOfSessionTitle(deps.titleOfSession(session));
-        if (callerProject && targetProject && targetProject !== callerProject) {
-          const targetName = agentNameOfTitle(deps.titleOfSession(session)) || deps.titleOfSession(session);
-          return {
-            ok: false,
-            crossProject: true,
-            callerProject,
-            targetProject,
-            error: `跨项目派活被拒：你属于「${callerProject}」，目标「${targetName}」属于「${targetProject}」。`
-              + `想用它的能力：先用 taskline_create 在本项目复制该成员（标题「${callerProject} · ${targetName}」，`
-              + `头像沿用它在「${targetProject}」tasks.json 里已有的 emoji，身份写明"从 ${targetProject} 借调"），再派活。`,
-          };
-        }
-      } catch (error) {
-        console.warn(`[hub-desktop-ui] project-boundary check failed: ${String(error)}`);
-      }
-      // 目标化派活（B）：写 tasks.json 的 goal + 在 prompt 最前面插目标化指令。
-      // 写回失败不影响投递（只在返回值里告警），因为投递本身是主目的。
-      let goalNote = '';
-      let goalTaskId = '';
-      let goalError = '';
-      let goalMatchedBy = '';
-      let goalCandidates = [];
-      let goalCreated = false;
-      let goalCreateError = '';
-      const goalText = String(args.goal || '').trim();
-      if (goalText) {
-        try {
-          const project = projectOfSessionTitle(deps.titleOfSession(session));
-          const agentName = agentNameOfTitle(deps.titleOfSession(session));
-          if (project) {
-            // 传了 task 就精确写那条线；没传时：setTaskGoal 在「同一成员属于多条线」时返回
-            // ambiguous + candidates（2026-10-22 用户纠正）；且**已有 goal 时拒绝覆盖**（P12-③）。
-            const wrote = setTaskGoal(
-              project, String(session.id), agentName, goalText, hostRoot(hub), String(args.task || ''),
-            );
-            if (wrote.ok) {
-              goalTaskId = wrote.taskId || '';
-              goalMatchedBy = wrote.matchedBy || '';
-            } else {
-              goalError = wrote.error || 'unknown';
-              if (Array.isArray(wrote.candidates)) goalCandidates = wrote.candidates;
-            }
-          } else {
-            goalError = '会话标题不是「<项目> · <成员>」格式，无法定位项目';
-          }
-        } catch (error) {
-          goalError = String(error && error.message);
-        }
-        // —— 真正替成员建 goal（2026-10-22）——
-        // 以前只发「请调用 create_goal」的文本指令，成员跳过就什么都没有；现在直接调
-        // DSH 的 goal 服务（ctx.goals = GoalService，签名 create(agent, {objective, maxGoalRounds})），
-        // 它会向**目标会话**的日志追加 `goal/change` 事件 —— 不依赖成员配合。
-        try {
-          const goalsSvc = hub.get('goals') || (typeof ctx.get === 'function' ? ctx.get('goals') : undefined);
-          const agentsSvc = hub.get('agents');
-          const targetAgent = (agentsSvc && typeof agentsSvc.get === 'function')
-            ? agentsSvc.get(String(session.id)) : undefined;
-          if (!goalsSvc || typeof goalsSvc.create !== 'function') {
-            goalCreateError = 'goal 服务（ctx.goals）不可用';
-          } else if (!targetAgent || !targetAgent.session) {
-            goalCreateError = '目标会话的 agent 不可用（可能未激活）';
-          } else {
-            try {
-              goalsSvc.create(targetAgent, { objective: goalText, maxGoalRounds: 12 });
-              goalCreated = true;
-            } catch (error) {
-              const msg = String((error && error.message) || error);
-              // 已有 goal：本质上"目标已存在"，不算失败
-              if (/GOAL_ALREADY_EXISTS|already exists/i.test(msg)) {
-                goalCreated = true;
-                goalCreateError = '已存在 goal（跳过重复创建）';
-              } else {
-                goalCreateError = msg;
-              }
-            }
-          }
-        } catch (error) {
-          goalCreateError = String((error && error.message) || error);
-        }
-        if (goalCreateError && !goalCreated) {
-          console.warn(`[hub-desktop-ui] taskline_prompt goal create failed: ${goalCreateError}`);
-        }
-        goalNote = goalDirective(goalText);
-      }
-      // —— 投递方式（2026-10-22）——
-      // 不传 mode = 老行为完全不变（controller.prompt mode:'queue' → agent.followup）。
-      // steer：controller.prompt mode:'steer' → agent.steer(message)（next-step 队列 + 唤醒），
-      //        只在目标 running 时有意义；空闲时退化为 queue。
-      // interrupt：controller.cancel({sessionId}) → agent.cancel({kind:'user'},{keepInbox:true})，
-      //        只中断当前轮、**不清 inbox**，已排队的下一条消息原样保留；
-      //        本条以 plugin-owned v4 消息排进 next-turn（不唤醒），等下次唤醒按序处理。
-      // 2026-11-08 用户令：默认投递方式从 queue 改成 triage —— 目标在跑就开分诊分身，不排队干等。
-      // 显式 mode:"queue" 仍可强制真排队；HUB_QUEUE_TRIAGE=0 全局回退旧行为。
-      // 2026-11-09 用户令（返回自相矛盾修复）：**一次快照 + 单一决策**——模式、note、
-      // 返回的 targetRunning、render 结论全部来自下面这一次 deps.snapshotTargetRunning。
-      const defaultMode = deps.queueTriageEnabled ? 'triage' : 'queue';
-      const requestedMode = String(args.mode || defaultMode).toLowerCase();
-      const agentsSvc = hub.get('agents');
-      const deliveryAgent = agentsSvc && typeof agentsSvc.get === 'function'
-        ? agentsSvc.get(String(session.id)) : undefined;
-      const runningSnapshot = await deps.snapshotTargetRunning(String(session.id));
-      const runningNow = runningSnapshot.running;
-      // interrupt 等 idle 的上限：调用方传 timeoutMs 就跟它走，否则用模块常量
-      //（长工具 abort 可能几秒；上限太短会误报 idle:false）
-      const requestedIdleWait = Number(args.timeoutMs);
-      const interruptIdleWaitMs = Number.isFinite(requestedIdleWait) && requestedIdleWait > 0
-        ? Math.min(Math.max(Math.floor(requestedIdleWait), 1000), 600000)
-        : INTERRUPT_IDLE_WAIT_MS;
-      const plan = planDelivery({
-        requestedMode,
-        running: runningNow,
-        triageEnabled: deps.queueTriageEnabled,
-        targetIsTriage: isQueueTriageTitle(deps.titleOfSession(session)),
-      });
-      let deliveredMode = plan.mode;
-      let modeNote = plan.note;
-      let interrupted = false;
-      let textQueued = false;
-      let idleAfterInterrupt;
-      const promptText = `${goalNote}${args.text}`;
-      if (deliveredMode === 'interrupt') {
-        if (!controller || typeof controller.cancel !== 'function') {
-          return { ok: false, error: 'sessionController.cancel 不可用，无法执行 interrupt' };
-        }
-        try {
-          await controller.cancel({ sessionId: String(session.id) });
-        } catch (error) {
-          return { ok: false, error: `中断失败：${String((error && error.message) || error)}` };
-        }
-        interrupted = true;
-        try {
-          if (deliveryAgent && deliveryAgent.inbox && typeof deliveryAgent.inbox.append === 'function') {
-            deliveryAgent.inbox.append('next-turn', noticeMessage(promptText, 'taskline-interrupt'));
-            textQueued = true;
-          } else {
-            modeNote = '拿不到目标 agent.inbox，本条未入队（已排队的消息仍保留）';
-          }
-        } catch (error) {
-          modeNote = `本条入队失败：${String((error && error.message) || error)}`;
-        }
-        idleAfterInterrupt = await deps.waitForAgentIdle(String(session.id), interruptIdleWaitMs);
-      }
-      // —— 分诊（2026-11-08 用户令）：目标在跑就不排队，立刻开分身判「steer 主线 / 分身自己做」——
-      let triageInfo = null;
-      if (deliveredMode === 'triage') {
-        const callerAgentForTriage = exec && exec.agent;
-        triageInfo = await deps.spawnQueueTriage({
-          targetId: String(session.id),
-          targetTitle: deps.titleOfSession(session),
-          callerTitle: callerAgentForTriage ? deps.callerTitleOf(callerAgentForTriage) : '',
-          callerSessionId: callerAgentForTriage && callerAgentForTriage.id !== undefined
-            ? String(callerAgentForTriage.id) : '',
-          // 传原始 text（不带 goal 指令前缀）：分诊分身看的是"这条消息本身"
-          text: String(args.text || ''),
-        });
-        if (!triageInfo.ok) {
-          // 分诊建不出来就退回普通排队——消息绝不能丢
-          deliveredMode = 'queue';
-          modeNote = `分诊分身建不出来（${triageInfo.error}），本条退回普通排队`;
-        }
-      }
-      try {
-        // 派活纪律（2026-10-26）：目标状态 + 排队位次直接进返回值；状态一律用上面
-        // 那**一次**快照，绝不在这里再查一次（2026-11-09：两处快照不一致正是本 bug）。
-        const targetRunning = runningNow;
-        const pendingBefore = deps.pendingDispatchesOf(session.id);
-        if (!interrupted && !(triageInfo && triageInfo.ok)) {
-          await controller.prompt({
-            requestId: `hub-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
-            sessionId: session.id,
-            mode: deliveredMode === 'steer' ? 'steer' : 'queue',
-            content: [{ type: 'text', text: promptText }],
-          }, new AbortController().signal);
-          deps.recordDispatch(session.id, targetRunning);
-        }
-        const pendingAfter = deps.pendingDispatchesOf(session.id);
-        const delivery = deliveryConclusion({
-          ok: true,
-          mode: deliveredMode,
-          targetRunning,
-          triageSessionId: triageInfo && triageInfo.ok ? triageInfo.sessionId : undefined,
-          interrupted,
-        });
-        return {
-          ok: true,
-          sessionId: session.id,
-          title: deps.titleOfSession(session),
-          // 派活纪律（2026-10-26）：目标状态 + 排队位次，直接进工具结果供管理者当场判断
-          targetRunning,
-          pendingDispatches: pendingAfter,
-          goal: goalText || '',
-          goalTaskId,
-          goalError,
-          // 三态：goalWritten = tasks.json 写入；goalCreated = 会话里真有 goal 事件；
-          // goalFailed = 建 goal 失败原因
-          goalWritten: Boolean(goalTaskId) && !goalError,
-          goalCreated,
-          goalFailed: goalText && !goalCreated ? (goalCreateError || 'unknown') : '',
-          goalMatchedBy,
-          ...(goalCandidates.length ? { candidates: goalCandidates } : {}),
-          mode: deliveredMode,
-          delivery,
-          ...(triageInfo && triageInfo.ok
-            ? { triageSessionId: triageInfo.sessionId, triageTitle: triageInfo.title }
-            : {}),
-          ...(interrupted ? { interrupted: true, textQueued } : {}),
-          ...(idleAfterInterrupt === undefined ? {} : { idle: idleAfterInterrupt }),
-          ...(modeNote ? { note: modeNote } : {}),
-          ...(pendingBefore > 0 ? { queuedBefore: pendingBefore } : {}),
-        };
-      } catch (error) {
-        return { ok: false, error: String(error && error.message) };
-      }
-    },
-  }));
-
-  // —— taskline_list ——
-  disposers.push(register({
-    name: 'taskline_list',
-    description: '列出所有可见会话（任务线）：sessionId、标题、是否运行中、是否分身。含重启后未激活的会话；sessionController 漏掉的冷会话从各项目 tasks.json 注册表补全（diag 里可见 rows/registry 两路计数）。',
-    parameters: { type: 'object', properties: {}, additionalProperties: false, required: [] },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['items'],
-        properties: {
-          items: {
-            type: 'array',
-            items: {
-              type: 'object',
-              additionalProperties: false,
-              required: ['sessionId', 'title', 'running', 'subagent'],
-              properties: {
-                sessionId: { type: 'string' },
-                title: { type: 'string' },
-                running: { type: 'boolean' },
-                subagent: { type: 'boolean' },
-              },
-            },
-          },
-          diag: { type: 'string' },
-        },
-      },
-      render: (_args, value) => [{
-        type: 'text',
-        text: (value.items.length === 0
-          ? '（没有活着的会话）'
-          : value.items.map((item) => `${item.sessionId}  ${item.title}${item.running ? ' [运行中]' : ''}${item.subagent ? ' [分身]' : ''}`).join('\n'))
-          + (value.diag ? `\n[diag] ${value.diag}` : ''),
-      }],
-    },
-    async execute() {
-      const sessions = hub.get('sessions');
-      // 底册用 sessionController.list()：读**全部可见会话**（含重启后未激活的冷会话），
-      // 不激活任何 Agent；行上的 running 官方已用 `agents.get(id)?.status === 'running'`
-      // 算好（Agent 的字段是 status 字符串，没有 running 布尔——之前读错位置恒为 false）。
-      const controller = hub.get('sessionController');
-      // 归档集合：registry-global 的 archivedSessionIds（api-session-controller 也这么读），
-      // 已归档/已回收的分身不该再出现在「活会话」列表里。
-      const registry = hub.get('workspaceRegistry');
-      const archivedSet = new Set(
-        registry && Array.isArray(registry.archivedSessionIds)
-          ? registry.archivedSessionIds.map(String)
-          : [],
-      );
-      let rows = null;
-      let rowsSource = 'none';
-      let listError = '';
-      if (controller && typeof controller.list === 'function') {
-        try {
-          const value = await controller.list(new AbortController().signal);
-          // list() 返回 {items:[...]}（Remote('list') 包装）或裸数组——两种都收
-          rows = value && Array.isArray(value.items) ? value.items : value;
-          if (Array.isArray(rows)) rowsSource = 'controller.list';
-        } catch (error) {
-          listError = String((error && error.message) || error);
-          console.warn(`[hub-desktop-ui] sessionController.list failed: ${listError}`);
-        }
-      }
-      if (!Array.isArray(rows)) {
-        // 兜底：controller 不可用时退回旧路径（只含活会话、无 running 判据）
-        const list = sessions && typeof sessions.list === 'function' ? sessions.list() : [];
-        rows = list.map((session) => ({
-          sessionId: session.id,
-          running: false,
-          origin: session.header && session.header.origin,
-          parentSessionId: session.header && session.header.parentSession,
-        }));
-        rowsSource = `fallback(${listError.slice(0, 60)})`;
-      }
-      const diagRunning = [];
-      const items = rows
-        .filter((row) => row && row.sessionId && !archivedSet.has(String(row.sessionId)))
-        .map((row) => {
-        const key = String(row.sessionId);
-        const live = sessions && typeof sessions.get === 'function' ? sessions.get(row.sessionId) : undefined;
-        // 标题：活会话走 sessionTitle；冷会话读官方缓存的 title 投影（用户改名=session/title 事件，已入缓存）
-        const projected = row.projections && row.projections.values ? row.projections.values.title : undefined;
-        const title = (live ? deps.titleOfSession(live) : '')
-          || (typeof projected === 'string' ? projected : '')
-          || `（未命名 ${String(row.sessionId).slice(0, 8)}…）`;
-        // 运行中：事件集合优先，其次 list 行现算字段（任一为真就算在跑）
-        const tracked = deps.liveRunning.has(key);
-        let agentStatus = 'n/a';
-        try {
-          const agents = hub.get('agents');
-          const agent = agents && typeof agents.get === 'function' ? agents.get(row.sessionId) : undefined;
-          agentStatus = agent ? String(agent.status) : 'no-agent';
-        } catch (error) { agentStatus = 'err'; }
-        // 运行中判据（实测校准）：`agents.get(id).status === 'running'` 是准的
-        //（诊断里自己的会话 st=running）；`sessionController.list()` 行里的 running
-        // 经 wire 传输后恒为 false，不可信；事件集合做兜底。
-        const running = agentStatus === 'running' || tracked || Boolean(row.running);
-        // 诊断：归档集合规模 + 被判为运行中的会话 id（排障用，正文不受影响）
-        if (running) diagRunning.push(key);
-        return {
-          sessionId: row.sessionId,
-          title,
-          running,
-          subagent: Boolean(row.origin === 'subagent' || row.parentSessionId
-            || (live && live.header && (live.header.origin === 'subagent' || live.header.parentSession))),
-        };
-      });
-      // —— 注册表补全（2026-10-22 修「taskline_list 只回 2-3 条」）——
-      // `sessionController.list()` 的返回行数实测会缩水（磁盘 175 会话/未归档约 27，
-      // 只回 3 行），管理者据此误判成员已归档、派错对象。各项目 tasks.json 的
-      // sessionIds 是协议要求维护的**注册表**：把里面未归档、且 list 没回的会话补进来
-      // （标题 = 项目 · 成员名），冷会话 running=false。归档集只用于排除，不裁剪活跃窗口。
-      const rowsRaw = rows.length;
-      const seen = new Set(items.map((item) => String(item.sessionId)));
-      let registryAdded = 0;
-      try {
-        const projectsDir = join(hostRoot(hub), '.hub', 'projects');
-        for (const dir of readdirSync(projectsDir)) {
-          let data = null;
-          try { data = JSON.parse(readFileSync(join(projectsDir, dir, 'tasks.json'), 'utf8')); } catch (error) { continue; }
-          if (!data || !Array.isArray(data.tasks)) continue;
-          for (const task of data.tasks) {
-            if (!task || task.status === 'archived') continue;
-            const members = Array.isArray(task.members) ? task.members : [];
-            const ids = Array.isArray(task.sessionIds) ? task.sessionIds.map(String) : [];
-            for (const id of ids) {
-              if (seen.has(id) || archivedSet.has(id)) continue;
-              seen.add(id);
-              registryAdded += 1;
-              const member = String(members[0] || task.title || '成员');
-              items.push({
-                sessionId: id,
-                title: `${dir} · ${member}`,
-                running: deps.liveRunning.has(id),
-                subagent: member.includes('｜'),
-              });
-            }
-          }
-        }
-      } catch (error) {
-        console.warn(`[hub-desktop-ui] registry merge failed: ${String(error)}`);
-      }
-      return {
-        items,
-        diag: `src=${rowsSource} rows=${rowsRaw} registry=+${registryAdded} archived=${archivedSet.size}`
-          + ` running=${diagRunning.length ? diagRunning.join(',') : 'none'}`,
-      };
-    },
-  }));
-
-  return disposers;
-}
+/**
+ * dsh-agent-tasks — AI-Agent-Hub 的任务线 / agent 通信工具。
+ *
+ * 2026-11-10 起从这里起步：先把 **agent_message**（146 行、只依赖 hub.get、完全自包含）
+ * 从 hub-desktop-ui/index.js 的 register 块（原 L6191-6337）搬过来，作为拆包的样板。
+ * 其余 11 个工具按同样方法逐个搬入（各自依赖已在拆包前查清：sessions / hub.get /
+ * core 的 projectOfSessionTitle+hostRoot / clone-handoff 的 collectEvents）。
+ *
+ * 用法（hub-desktop-ui 里）：
+ *   import { registerAgentTools } from 'dsh-agent-tasks';
+ *   const disposers = registerAgentTools({ hub, register, deps });
+ */
+export const PACKAGE_VERSION = '0.1.0';
+
+/**
+ * 注册本包负责的工具。
+ * @param {{ hub: object, register: (definition: object) => unknown, deps?: object }} opts
+ * @returns {unknown[]} disposers（与 tools.register 的返回值一致）
+ */
+import { existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { homedir, tmpdir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { collectEvents, writeCloneHandoff } from 'dsh-clone-handoff';
+import {
+  agentNameOfTitle,
+  cleanCloneRegistry,
+  dedupeActiveTitles,
+  deliveryConclusion,
+  ensureLiveSession,
+  ensureMemberAvatar,
+  goalDirective,
+  guardRoutingFile,
+  hostRoot,
+  INTERRUPT_IDLE_WAIT_MS,
+  isQueueTriageTitle,
+  looksTaskSpecificName,
+  noticeMessage,
+  planDelivery,
+  projectOfSessionTitle,
+  pruneArchivedSessions,
+  readJsonForWrite,
+  readRegisteredSessionIds,
+  readTaskFile,
+  renderTasklinePrompt,
+  resumeInterruptedSessions,
+  setTaskGoal,
+  writeJsonAtomic,
+  resumeLedgerPath,
+  RESUME_PROMPT,
+  RESUME_MAX_PER_BOOT,
+  titleOf,
+  readGlobalAvatars,
+  writeGlobalAvatar,
+  AVATAR_POOL,
+  recordResumeSweep,
+  shouldSkipResumeByLedger,
+  projectsDir,
+  boardPath,
+  tasksPath,
+  routingPath,
+  handoffsDir,
+  triageDecisionOf,
+  readSessionEvents,
+  compactSessionEvents,
+} from 'dsh-hub-core';
+
+export function registerAgentTools({ hub, register, deps = {} }) {
+  // defaultPreset（2026-11-10 修）：12 个工具迁出 hub-desktop-ui 时漏注入了这个。
+  // 因为 taskline_create 里写的是 `args.preset || defaultPreset`（短路求值），
+  // 只要调用方传了 preset 就永远不会求值 → 一直没暴露；
+  // 一旦不传 preset 就直接 ReferenceError: defaultPreset is not defined。
+  // 兜底 'cordis' 与 hub-desktop-ui 那边 `config.defaultPreset || 'cordis'` 保持一致。
+  const { callerTitleOf, isRunningNow, pendingDispatchesOf, recordDispatch, resolveSession, snapshotTargetRunning, spawnQueueTriage, titleOfSession, waitForAgentIdle, wakeAgentMessageTarget, liveRunning, queueTriageEnabled, defaultPreset = 'cordis', restart: restartDesktop = null } = deps;
+  const disposers = [];
+
+  // —— hub_restart（2026-11-12 用户令「注册一个 hub_restart 工具让 agent 直接调」）——
+  // 场景：改的是 Host 侧插件代码/配置，必须重启才生效；让 agent 自己重启，不用用户手点。
+  // 实现要点：延迟 delayMs（默认 1.5s）再调 restartDesktop()，保证本条工具结果先回到模型；
+  // 重启会中断当前回合，DSH 重启后本会话自动续跑。
+  disposers.push(register({
+    name: 'hub_restart',
+    description: '重启 DSH 桌面端。改动的插件 / 配置需要重启才生效时用它。'
+      + '默认延迟 1.5 秒执行（让本条结果先回到你这边）；重启会中断当前回合，重启后本会话自动续跑。'
+      + '25 秒内重复调用会被防抖跳过；不想等可以直接把 delayMs 调小。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        reason: { type: 'string', description: '为什么要重启（写进重启日志，便于以后回溯）' },
+        delayMs: { type: 'integer', description: '延迟多少毫秒后再关（默认 1500，范围 500~10000）' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok', 'scheduled'],
+        properties: {
+          ok: { type: 'boolean' },
+          scheduled: { type: 'boolean' },
+          delayMs: { type: 'integer' },
+          note: { type: 'string' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: value.ok
+          ? `已排定重启：${value.delayMs}ms 后关闭 DSH（本回合会被中断，重启后会话自动续跑）`
+          : `重启排定失败：${value.error || '未知原因'}`,
+      }],
+    },
+    async execute(args = {}) {
+      if (typeof restartDesktop !== 'function') {
+        return { ok: false, scheduled: false, error: '宿主未注入 restart（dsh-desktop-watchdog 未加载？）' };
+      }
+      const delay = Math.min(10000, Math.max(500, Number(args.delayMs) || 1500));
+      setTimeout(() => {
+        try {
+          const result = restartDesktop();
+          console.log(`[hub_restart] agent 请求重启 reason=${args.reason || '-'} result=${String(result)}`);
+        } catch (error) {
+          console.warn(`[hub_restart] 重启失败: ${String((error && error.message) || error)}`);
+        }
+      }, delay);
+      return { ok: true, scheduled: true, delayMs: delay, note: `reason=${args.reason || '-'}` };
+    },
+  }));
+
+  // —— agent_message（2026-10-23 用户令；原 hub-desktop-ui L6191-6337）——
+  disposers.push(register({
+        name: 'agent_message',
+        description: '给任意 agent（含其它项目）直接发一条消息：讨论、要资料、同步状态、协作求解。'
+          + '交流放行（跨项目可用）；正式任务分派仍走本项目管理者的 taskline_prompt。'
+          + 'mode 默认 steer=**中途插队**（目标在跑时在下一个 step 边界插入当前轮，不打断正在执行的工具；目标空闲自动退化为排队），'
+          + 'mode=queue 才是排队等回合结束。'
+          + '别用它给忙碌的 agent 反复轰炸转派任务——接活请走管理者。',
+        parameters: {
+          type: 'object',
+          additionalProperties: false,
+          required: ['target', 'text'],
+          properties: {
+            target: { type: 'string', description: '目标：完整 sessionId 或「项目 · 成员」标题（可部分匹配）' },
+            text: { type: 'string', description: '要说的话（会自动加【来自 <你>】前缀）' },
+            replyExpected: { type: 'boolean', description: 'true 时文末提示对方回一句（默认不加）' },
+            mode: {
+              type: 'string',
+              enum: ['steer', 'queue'],
+              description: '投递模式：steer（默认）= 目标在跑时插进当前轮的下一个 step 边界（不打断当前工具调用；目标空闲退化为排队）；'
+                + 'queue = 排队等它当前回合结束',
+            },
+          },
+        },
+        output: {
+          schema: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['ok'],
+            properties: {
+              ok: { type: 'boolean' },
+              sessionId: { type: 'string' },
+              targetTitle: { type: 'string' },
+              crossProject: { type: 'boolean' },
+              callerTitle: { type: 'string' },
+              ambiguous: { type: 'boolean' },
+              candidates: { type: 'array', items: { type: 'string' } },
+              mode: { type: 'string' },
+              woke: { type: 'boolean' },
+              wakeNote: { type: 'string' },
+              error: { type: 'string' },
+            },
+          },
+          render: (_args, value) => [{
+            type: 'text',
+            text: value.ok
+              ? `已发给「${value.targetTitle}」${value.crossProject ? '（跨项目）' : ''}${value.woke ? '，并已唤醒它开始回复' : (value.wakeNote ? `（未唤醒：${value.wakeNote}）` : '')}`
+              : (value.ambiguous
+                ? `命中多个会话，请用完整 sessionId 重发：\n${(value.candidates || []).join('\n')}`
+                : `发送失败：${value.error || 'unknown'}`),
+          }],
+        },
+        async execute(args, exec) {
+          const controller = hub.get('sessionController');
+          if (!controller || typeof controller.prompt !== 'function') {
+            return { ok: false, error: 'sessionController 不可用' };
+          }
+          // P8-①（2026-10-29）：text 缺失/非字符串时拒绝投递（同 taskline_prompt 防 undefined）
+          if (typeof args.text !== 'string' || !args.text.trim()) {
+            return { ok: false, error: '缺少 text（收到 undefined/空/非字符串）。请检查 agent_message 调用参数后重发；本条未投递。' };
+          }
+          const ref = String(args.target || '').trim();
+          const isExactId = /^session-[0-9a-f-]{20,}$/i.test(ref);
+          // 目标解析：完整 id 直用；标题片段跨**全部项目**清点（同名列候选）
+          let session = isExactId ? deps.resolveSession(ref) : undefined;
+          let ambiguity = null;
+          if (!session) {
+            try {
+              const value = await controller.list(new AbortController().signal);
+              const rows = value && Array.isArray(value.items) ? value.items : (Array.isArray(value) ? value : []);
+              const registry = hub.get('workspaceRegistry');
+              const archivedSet = new Set(
+                registry && Array.isArray(registry.archivedSessionIds)
+                  ? registry.archivedSessionIds.map(String) : [],
+              );
+              const candidates = [];
+              for (const row of rows) {
+                if (!row || !row.sessionId || archivedSet.has(String(row.sessionId))) continue;
+                const t = row.projections && row.projections.values && typeof row.projections.values.title === 'string'
+                  ? row.projections.values.title : '';
+                if (!t || !t.includes(ref)) continue;
+                candidates.push({ id: String(row.sessionId), title: t });
+              }
+              if (candidates.length === 1) {
+                session = { id: candidates[0].id, displayTitle: candidates[0].title };
+              } else if (candidates.length > 1) {
+                ambiguity = candidates;
+              }
+            } catch (error) { /* 清点失败退回 live 解析 */ }
+          }
+          if (!session) session = deps.resolveSession(ref);
+          if (ambiguity && ambiguity.length > 1) {
+            return {
+              ok: false,
+              ambiguous: true,
+              candidates: ambiguity.map((c) => `${c.title} ${c.id}`),
+              error: '同名多个会话',
+            };
+          }
+          if (!session) return { ok: false, error: '找不到这个会话（可用 taskline_list 查完整 sessionId）' };
+          // 唤醒 + 投递（ensureLiveSession 每次 resolveAgent，冷会话也能收）
+          const live = await ensureLiveSession(hub, controller, String(session.id));
+          if (!live.ok) return { ok: false, error: live.error || '会话不可用' };
+          const callerAgent = exec && exec.agent;
+          const callerTitle = callerAgent ? deps.callerTitleOf(callerAgent) : '';
+          const targetTitle = deps.titleOfSession(live.session) || session.displayTitle || '';
+          const projectOfTitle = (t) => (t && t.includes(' · ') ? t.slice(0, t.lastIndexOf(' · ')).trim() : '');
+          const crossProject = Boolean(
+            projectOfTitle(callerTitle) && projectOfTitle(targetTitle)
+            && projectOfTitle(targetTitle) !== projectOfTitle(callerTitle),
+          );
+          const body = `【来自 ${callerTitle || '某 agent'}】${String(args.text || '').trim()}`
+            + (args.replyExpected ? '\n（方便的话回我一句）' : '');
+          // 投递模式（2026-10-23 用户令「要可以中途插队」）：默认 steer。
+          // steer = 目标在跑时在下一个 step 边界插入当前轮（不打断正在执行的工具调用）；
+          // 目标空闲时 DSH 侧自动退化为排队 —— 所以如实回报「实际生效模式」。
+          const requestedMode = args.mode === 'queue' ? 'queue' : 'steer';
+          let targetRunning = false;
+          try {
+            const agents = hub.get('agents');
+            const agent = agents && typeof agents.get === 'function' ? agents.get(String(live.session.id)) : undefined;
+            targetRunning = Boolean(agent && String(agent.status) === 'running');
+          } catch (error) { /* 取不到就按空闲处理 */ }
+          const effectiveMode = requestedMode === 'steer' && !targetRunning ? 'queue' : requestedMode;
+          try {
+            await controller.prompt({
+              requestId: `agent-msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+              sessionId: String(live.session.id),
+              mode: requestedMode,
+              content: [{ type: 'text', text: body }],
+            }, new AbortController().signal);
+            // P3（2026-10-27 杨航拍板「允许跨项目自动唤醒」）：投递后若目标仍空闲，
+            // 复用 resume_session 的同一实现唤醒一次，避免只建空 turn（lastTurn+1 / response=""）。
+            const wake = await deps.wakeAgentMessageTarget(String(live.session.id));
+            return {
+              ok: true,
+              sessionId: String(live.session.id),
+              targetTitle,
+              crossProject,
+              callerTitle,
+              mode: effectiveMode,
+              ...(wake.woke ? { woke: true } : {}),
+              ...(wake.reason ? { wakeNote: wake.reason } : {}),
+            };
+          } catch (error) {
+            return { ok: false, error: String((error && error.message) || error) };
+          }
+        },
+      }
+  ));
+
+  // —— vision_read ——
+  disposers.push(register({
+    name: 'vision_read',
+    description: '⛔【视觉模型调用即违规】能收图的模型（inputModalities 含 image）请直接读附件或 read_image，**不要调用本工具**——'
+      + '本工具仅供**确认无图像输入能力的纯文本模型**兜底。'
+      + '功能：让视觉模型替你看图，返回文字结果（描述 / 针对某个问题回答 / OCR 逐字转写）。'
+      + '违反示例：视觉模型调用它 = 把原图转述成有损文字、多跳一次常失败的后端、浪费 token。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['source'],
+      properties: {
+        source: { type: 'string', description: '图片路径：绝对路径、~ 开头或 file:// URL；无扩展名也能识别（按文件头）' },
+        question: { type: 'string', description: '要问的问题；省略则返回整体描述' },
+        ocr: { type: 'boolean', description: 'true = 逐字转写图中所有文字（此时忽略 question）' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok', 'text'],
+        properties: {
+          ok: { type: 'boolean' },
+          text: { type: 'string' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: value.ok ? value.text : `vision_read 失败：${value.error || '未知原因'}`,
+      }],
+    },
+    timeoutMs: 300000,
+    async execute(args, exec) {
+      // ① 提示视觉模型"你本来就能看图"（2026-10-26 软化：不再硬拒答——
+      // 客户端拦截后图片以路径文本进会话，视觉模型拿不到附件内容时也该能代看，
+      // 否则会出现"路径给了但谁也看不了"的死角）。判定不出就照常工作。
+      let visionModelNote = '';
+      try {
+        const llm = hub.get('llm');
+        let selection;
+        try {
+          const agentsSvc = hub.get('agents');
+          const ref = agentsSvc && typeof agentsSvc.selectionFor === 'function'
+            ? agentsSvc.selectionFor(exec.agent) : undefined;
+          selection = ref && ref.current;
+        } catch (error) { /* 忽略 */ }
+        if (!selection && exec.agent && typeof exec.agent.currentSelection === 'function') {
+          selection = exec.agent.currentSelection();
+        }
+        if (selection && llm && typeof llm.resolveModelInfo === 'function') {
+          const info = await llm.resolveModelInfo(selection.provider, selection.model, exec.signal);
+          const modalities = info && info.inputModalities;
+          if (Array.isArray(modalities) && modalities.includes('image')) {
+            visionModelNote = `\n\n[注：当前模型（${selection.model}）支持图像输入；若你能直接看到该图片附件，优先以原生视图为准。]`;
+          }
+        }
+      } catch (error) { /* 判定失败：继续执行 */ }
+
+      // ② 定位 vision-tools 工具包
+      const toolkitCandidates = [
+        process.env.DSH_VISION_TOOLKIT,
+        join(homedir(), 'Documents', 'GitHub', 'AI-Agent-Hub', 'skills', 'vision-tools'),
+        join(homedir(), '.dsh', 'skills', 'vision-tools'),
+      ].filter(Boolean);
+      const toolkit = toolkitCandidates.find((dir) => existsSync(join(dir, 'bin', 'glance')));
+      if (!toolkit) {
+        return { ok: false, text: '', error: `找不到 vision-tools（试过：${toolkitCandidates.join(' | ')}）` };
+      }
+      const scriptsDir = join(toolkit, 'scripts');
+
+      // ③ python 解释器
+      const pythonCandidates = [
+        process.env.DSH_VISION_PYTHON,
+        join(process.env.LOCALAPPDATA || '', 'Programs', 'Python', 'Python313', 'python.exe'),
+        'python',
+      ].filter(Boolean);
+      const python = pythonCandidates.find((exe) => exe === 'python' || existsSync(exe)) || 'python';
+
+      // ④ 图片路径 + 扩展名归一（DSH 附件对象名是 sha256，没有扩展名）
+      let raw = String(args.source || '').trim();
+      if (!raw) return { ok: false, text: '', error: 'source 不能为空' };
+      if (raw.startsWith('file://')) {
+        try { raw = decodeURIComponent(new URL(raw).pathname).replace(/^\/([A-Za-z]:)/, '$1'); } catch (error) { /* 保留原样 */ }
+      }
+      if (raw.startsWith('~')) raw = join(homedir(), raw.slice(1));
+      const imagePath = resolve(raw);
+      if (!existsSync(imagePath)) return { ok: false, text: '', error: `图片不存在：${imagePath}` };
+      const knownExt = /\.(png|jpe?g|gif|webp)$/i.test(imagePath);
+      let stagedPath = imagePath;
+      let tempPath = '';
+      if (!knownExt) {
+        let magic = '';
+        try { magic = readFileSync(imagePath).subarray(0, 12).toString('latin1'); } catch (error) { /* ignore */ }
+        const ext = magic.startsWith('\u0089PNG') ? '.png'
+          : magic.startsWith('\u00ff\u00d8\u00ff') ? '.jpg'
+          : magic.startsWith('GIF8') ? '.gif'
+            : (magic.slice(0, 4) === 'RIFF' && magic.slice(8, 12) === 'WEBP') ? '.webp'
+              : '';
+        if (!ext) return { ok: false, text: '', error: `无法识别图片格式（支持 png/jpeg/gif/webp）：${imagePath}` };
+        tempPath = join(tmpdir(), `dsh-vision-${randomUUID()}${ext}`);
+        try { writeFileSync(tempPath, readFileSync(imagePath)); } catch (error) {
+          return { ok: false, text: '', error: `暂存图片失败：${String(error && error.message)}` };
+        }
+        stagedPath = tempPath;
+      }
+
+      // ⑤a 首选 glance（skills/vision-tools 的本地视觉后端）
+      const askQuestion = args.ocr === true
+        ? '请逐字转写图里所有文字（保持原有换行与标点），不要解释。'
+        : (args.question ? String(args.question) : '请描述这张图片：整体内容、关键元素、图内可见文字。');
+      const cliArgs = [join(toolkit, 'bin', 'glance'), stagedPath];
+      if (args.ocr === true) cliArgs.push('--ocr');
+      else if (args.question) cliArgs.push('-q', String(args.question));
+
+      const runOnce = () => new Promise((resolveRun) => {
+        const child = spawn(python, cliArgs, {
+          cwd: toolkit,
+          env: { ...process.env, PYTHONPATH: scriptsDir },
+          windowsHide: true,
+        });
+        let out = '';
+        let err = '';
+        const timer = setTimeout(() => { try { child.kill(); } catch (error) { /* ignore */ } }, 280000);
+        child.stdout.on('data', (chunk) => { out += chunk.toString(); });
+        child.stderr.on('data', (chunk) => { err += chunk.toString(); });
+        child.on('error', (error) => { clearTimeout(timer); resolveRun({ code: -1, out, err: String(error && error.message) }); });
+        child.on('close', (code) => { clearTimeout(timer); resolveRun({ code, out, err }); });
+      });
+
+      // ⑤b 兜底后端：OpenAI 兼容的视觉 Chat API（2026-10-26：本机 vision-tools 的
+      // token-plan 后端全线 403 AccessDenied.Unpurchased，改用已验证接受图像输入的
+      // Ark DeepSeek V4.1 经济版；可用环境变量覆盖 base/model/key）。
+      const readArkKey = () => {
+        if (process.env.DSH_VISION_API_KEY) return process.env.DSH_VISION_API_KEY;
+        try {
+          const creds = readFileSync(join(homedir(), '.dsh', '.credentials.yaml'), 'utf8');
+          const m = /ARK_AGENT_PLAN_API_KEY:\s*['"]?([^'"\s]+)['"]?/.exec(creds);
+          if (m) return m[1];
+        } catch (error) { /* ignore */ }
+        return process.env.ARK_AGENT_PLAN_API_KEY || '';
+      };
+      const fallbackVision = async () => {
+        const key = readArkKey();
+        if (!key) return { ok: false, error: '没有可用的视觉 API key（DSH_VISION_API_KEY / ARK_AGENT_PLAN_API_KEY）' };
+        const base = String(process.env.DSH_VISION_BASE_URL || 'https://ark.cn-beijing.volces.com/api/plan/v3').replace(/\/+$/, '');
+        const model = String(process.env.DSH_VISION_MODEL || 'deepseek-v4-1-flash-economy-261017');
+        let b64 = '';
+        try { b64 = readFileSync(stagedPath).toString('base64'); } catch (error) {
+          return { ok: false, error: `读取图片失败：${String(error && error.message)}` };
+        }
+        const mime = /\.jpe?g$/i.test(stagedPath) ? 'image/jpeg'
+          : /\.gif$/i.test(stagedPath) ? 'image/gif'
+            : /\.webp$/i.test(stagedPath) ? 'image/webp' : 'image/png';
+        const body = JSON.stringify({
+          model,
+          max_tokens: 2048,
+          messages: [{
+            role: 'user',
+            content: [
+              { type: 'text', text: askQuestion },
+              { type: 'image_url', image_url: { url: `data:${mime};base64,${b64}` } },
+            ],
+          }],
+        });
+        try {
+          const res = await fetch(`${base}/chat/completions`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json', authorization: `Bearer ${key}` },
+            body,
+            signal: AbortSignal.timeout(180000),
+          });
+          const raw = await res.text();
+          if (res.status >= 400) return { ok: false, error: `HTTP ${res.status}: ${raw.slice(0, 400)}` };
+          const data = JSON.parse(raw);
+          const text = String((((data.choices || [])[0] || {}).message || {}).content || '').trim();
+          return text ? { ok: true, text: `${text}\n\n[via fallback vision model ${model}]` }
+            : { ok: false, error: `视觉后端返回空内容：${raw.slice(0, 300)}` };
+        } catch (error) {
+          return { ok: false, error: String(error && error.message) };
+        }
+      };
+
+      try {
+        const result = await runOnce();
+        const text = String(result.out || '').trim();
+        if (result.code === 0 && text) return { ok: true, text: text + visionModelNote };
+        const detail = String(result.err || '').trim() || text || `退出码 ${result.code}`;
+        // glance 后端失败 → 走兜底视觉模型（不把两段错误都抛给模型，只留摘要）
+        const fallback = await fallbackVision();
+        if (fallback.ok) return { ok: true, text: fallback.text + visionModelNote };
+        return {
+          ok: false,
+          text: '',
+          error: `glance 失败：${detail.slice(0, 500)}；兜底也失败：${String(fallback.error || '').slice(0, 500)}`,
+        };
+      } finally {
+        if (tempPath) { try { rmSync(tempPath, { force: true }); } catch (error) { /* ignore */ } }
+      }
+    },
+  }));
+
+  // —— routing_put ——
+  disposers.push(register({
+    name: 'routing_put',
+    description: '把用户消息归到任务线：合并写入 .hub/projects/<项目>/routing.json（原子写+自愈，不会覆盖已有条目）。'
+      + '代替手工 read+edit routing.json——归线一律走这里。'
+      + 'entries={"eventId":"taskId"} 逐条给；或 ids=[...] + lane="t7" 批量归同一条线。'
+      + 'taskId 取值：_none（过程消息）/ meeting（会议）/ t<数字>（任务线）。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['project'],
+      properties: {
+        project: { type: 'string', description: '项目名（.hub/projects/ 下的目录名）' },
+        entries: {
+          type: 'object',
+          description: '{ "<eventId>": "<taskId>" } 逐条映射；eventId 是 taskline_messages 返回的 eventId',
+          additionalProperties: { type: 'string' },
+        },
+        ids: { type: 'array', items: { type: 'string' }, description: '批量归同一条线时的事件 id 列表（与 lane 搭配）' },
+        lane: { type: 'string', description: '批量模式的目标 taskId（如 t7 / _none / meeting）' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok'],
+        properties: {
+          ok: { type: 'boolean' },
+          written: { type: 'number' },
+          skipped: { type: 'array', items: { type: 'string' } },
+          total: { type: 'number' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: value.ok
+          ? `routing.json 已合并写入 ${value.written} 条（总 ${value.total} 条）${value.skipped && value.skipped.length ? `；跳过已存在/非法：${value.skipped.join('、')}` : ''}`
+          : `写入失败：${value.error || 'unknown'}`,
+      }],
+    },
+    async execute(args) {
+      try {
+        const project = String(args.project || '').trim().replace(/[\\/:*?"<>|]/g, '_');
+        if (!project) return { ok: false, error: 'project 不能为空' };
+        // 组装待写映射
+        const want = {};
+        const skipped = [];
+        // P12-①（2026-11-02）：原来只认 `t<数字>`，但星阶等项目用的是**语义 taskId**
+        // （status / stelscala-pm / week-plan-daily-exclude…），导致整批被 skipped
+        // → 「没有可写条目」。现改为：`_none`/`meeting` 直通 ∪ tasks.json 里的真实 id ∪ slug 兜底。
+        let knownTaskIds = new Set();
+        try {
+          const tasksFile = join(hostRoot(hub), '.hub', 'projects', project, 'tasks.json');
+          const tasksRaw = readJsonForWrite(tasksFile);
+          if (tasksRaw.ok && tasksRaw.value && Array.isArray(tasksRaw.value.tasks)) {
+            knownTaskIds = new Set(tasksRaw.value.tasks
+              .map((t) => (t && (t.id || t.taskId)) ? String(t.id || t.taskId) : '')
+              .filter(Boolean));
+          }
+        } catch { /* 读不到 tasks.json 就只靠 slug 兜底 */ }
+        const validLane = (v) => {
+          const lane = String(v || '');
+          if (lane === '_none' || lane === 'meeting') return true;
+          if (knownTaskIds.has(lane)) return true;
+          // slug 兜底：小写字母/数字开头，允许字母数字 _ - .（防手滑写成员名/中文进去）
+          return /^[a-z0-9][a-z0-9_.-]{0,63}$/i.test(lane);
+        };
+        if (args.entries && typeof args.entries === 'object' && !Array.isArray(args.entries)) {
+          for (const [id, lane] of Object.entries(args.entries)) {
+            if (!id || !validLane(lane)) { skipped.push(`${id}:${lane}`); continue; }
+            want[String(id)] = String(lane);
+          }
+        }
+        if (Array.isArray(args.ids) && args.ids.length) {
+          const lane = String(args.lane || '');
+          if (!validLane(lane)) return { ok: false, error: `lane 非法：${lane}（须 _none/meeting/t<数字>）` };
+          for (const id of args.ids) { if (id) want[String(id)] = lane; }
+        }
+        if (Object.keys(want).length === 0) {
+          const known = [...knownTaskIds].slice(0, 12).join(' / ') || '（tasks.json 无可用 id）';
+          return {
+            ok: false,
+            error: '没有可写条目。用法：entries={"<eventId>":"<taskId>"} 或 ids=[...]+lane="<taskId>"；'
+              + `taskId 可为 _none / meeting / 本项目 tasks.json 里的 id（如 ${known}）。`
+              + (skipped.length ? ` 被跳过的项：${skipped.slice(0, 5).join('、')}` : ''),
+            skipped,
+          };
+        }
+        const file = join(hostRoot(hub), '.hub', 'projects', project, 'routing.json');
+        // 写前自愈对账（2026-10-26 同款），再走「读→合并→原子写」，绝不整文件覆盖
+        guardRoutingFile(project, hostRoot(hub));
+        const read = readJsonForWrite(file);
+        if (!read.ok) return { ok: false, error: `routing.json 读取失败：${String(read.error)}` };
+        const routing = read.value || {};
+        let written = 0;
+        for (const [id, lane] of Object.entries(want)) {
+          if (routing[id]) { skipped.push(`${id}(已有)`); continue; }
+          routing[id] = lane;
+          written += 1;
+        }
+        if (written > 0) writeJsonAtomic(file, routing);
+        return { ok: true, written, skipped, total: Object.keys(routing).length };
+      } catch (error) {
+        return { ok: false, error: String((error && error.message) || error) };
+      }
+    },
+  }));
+
+  // —— taskline_messages ——
+  disposers.push(register({
+    name: 'taskline_messages',
+    description: '读取某个会话最近的消息，带 eventId（用于把用户消息归到具体任务线）。'
+      + '默认每条截 400 字；full=true 时截 4000 字（超长内容请让对方写文件给路径，别靠本工具全文搬运）。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['session'],
+      properties: {
+        session: { type: 'string', description: 'sessionId 或标题片段' },
+        limit: { type: 'number', description: '返回最近多少条，默认 20' },
+        full: { type: 'boolean', description: 'true=每条最多 4000 字（默认 400 字截断）' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok'],
+        properties: {
+          ok: { type: 'boolean' },
+          error: { type: 'string' },
+          // t38-A：三态外显（ok=有消息 / empty=会话真空 / unreadable=读不到）
+          state: { type: 'string' },
+          title: { type: 'string' },
+          diagnosis: { type: 'string' },
+          items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              additionalProperties: false,
+              required: ['eventId', 'role', 'text'],
+              properties: {
+                eventId: { type: 'string' },
+                role: { type: 'string' },
+                time: { type: 'number' },
+                text: { type: 'string' },
+              },
+            },
+          },
+        },
+      },
+      render: (_args, value) => {
+        if (!value.ok) return [{ type: 'text', text: `读取失败：${value.error}` }];
+        if (!value.items || value.items.length === 0) {
+          // 三态可区分（t38-A，2026-11-10）：空会话 ≠ 读不到。以前两者都显示
+          //「这个会话没有消息」，导致把「读不到」误当「没消息」，归线随之断链。
+          if (value.state === 'empty') {
+            return [{ type: 'text', text: `（会话存在但确实还没有消息：${value.diagnosis || value.title || ''}）` }];
+          }
+          if (value.state === 'unreadable') {
+            return [{ type: 'text', text: `读取失败（读不到，不是空会话）：${value.diagnosis || value.error || '未知原因'}` }];
+          }
+          return [{ type: 'text', text: '（这个会话没有消息）' }];
+        }
+        return [{
+          type: 'text',
+          text: value.items
+            .map((item) => `${item.eventId}  ${item.role === 'user' ? '我' : 'agent'}  ${item.text}`)
+            .join('\n'),
+        }];
+      },
+    },
+    async execute(args) {
+      let session = deps.resolveSession(args.session);
+      if (!session) {
+        // t38-A（2026-11-10）：resolveSession 只查内存 sessions.list()，冷/僵尸会话会被判「找不到」。
+        // 若传的是完整 sessionId，就先当 id 直读持久日志（与 /sync/messages 同口径），
+        // 读得到就正常返回；读不到再明确回「读不到」而不是含糊的「找不到」。
+        const raw = String(args.session || '').trim();
+        if (/^session-[0-9a-f-]{16,}$/i.test(raw)) {
+          let probe = [];
+          try {
+            const read = await readSessionEvents(hub, raw);
+            probe = Array.isArray(read && read.events) ? read.events : [];
+          } catch { /* 下面按读不到处理 */ }
+          if (probe.length) {
+            session = { id: raw, title: raw, coldFallback: true, events: probe };
+          } else {
+            return {
+              ok: true,
+              items: [],
+              state: 'unreadable',
+              title: raw,
+              diagnosis: '该 sessionId 既不在内存会话列表，持久日志也读不到（壳可能已被换掉或日志已删）；'
+                + '请用 taskline_list 取当前 sessionId。',
+            };
+          }
+        } else {
+          return { ok: false, error: '找不到这个会话' };
+        }
+      }
+      const limit = Number.isFinite(args.limit) && args.limit > 0 ? Math.floor(args.limit) : 20;
+      // P6（2026-10-27 夜场）：默认截断 140→400 字；full=true 不截断（上限 4000 防爆）。
+      // 长回报的标准做法仍是「写临时文件 + 消息给路径」，full 只用于核对关键句。
+      const fullCap = 4000;
+      const clip = (t) => String(t)
+        .replace(/\s+/g, ' ')
+        .slice(0, args.full === true ? fullCap : 400);
+      // t38-A（2026-11-10 修「对部分会话恒返空/读不到」）：
+      // 旧实现只看 session.events（活会话）→ controller.inspect 的 data.message（活格式）。
+      // 冷会话（如日常·Yat2 停着的线、PrimCell·Yat2）恰恰是：①内存里没有 events；
+      // ②持久日志把回复存成 assistant/chunk 的 block-end/text-chunks，正文不在 data.message。
+      // 于是两条都落空 → 恒返「没有消息」。现改为走 hub-core 的 readSessionEvents（活+冷都读）
+      // + compactSessionEvents（把 chunk 形态重建成 assistant/message 正文），
+      // 并对「会话存在但真空」与「读不到」分别给出可判定状态。
+      const sid = session.id || (session && session.sessionId) || '';
+      let events = [];
+      let readError = '';
+      try {
+        const read = await readSessionEvents(hub, sid);
+        events = Array.isArray(read && read.events) ? read.events : [];
+      } catch (error) {
+        readError = String((error && error.message) || error);
+      }
+      if (events.length) {
+        try {
+          // compactSessionEvents 返回 { events, lastSeq, streaming }（不是数组，2026-11-10 实测）
+          const compacted = compactSessionEvents(events);
+          const rebuilt = Array.isArray(compacted) ? compacted
+            : (compacted && Array.isArray(compacted.events) ? compacted.events : []);
+          if (rebuilt.length) events = rebuilt;
+        } catch (error) {
+          console.warn(`[hub-desktop-ui] compactSessionEvents failed: ${String(error)}`);
+        }
+      }
+      const items = [];
+      for (const event of events) {
+        if (!event || (event.type !== 'user/message' && event.type !== 'assistant/message')) continue;
+        const data = event.data || {};
+        const message = data.message || data;
+        if (message && message.role === 'user') {
+          const source = message.source || {};
+          if (source.kind && source.kind !== 'user') continue;
+        }
+        const parts = Array.isArray(message.content) ? message.content : [];
+        const text = clip(parts
+          .filter((part) => part && part.type === 'text' && typeof part.text === 'string')
+          .map((part) => part.text)
+          .join('\n')
+          .trim());
+        if (!text) continue;
+        items.push({
+          eventId: String(event.id || event.key || event.seq || ''),
+          role: message.role === 'user' ? 'user' : 'agent',
+          time: Number(event.time || 0),
+          text,
+        });
+      }
+      // 三态判定（t38-A）：有消息 / 会话确实空 / 读不到。
+      if (items.length === 0) {
+        // 「读不到」判据：连一个事件都没拿到（不是拿到事件但都无正文）。
+        if (!events.length) {
+          return {
+            ok: true,
+            items: [],
+            state: 'unreadable',
+            title: (session && (session.title || session.name)) || '',
+            diagnosis: `会话在注册表可见，但事件池为空${readError ? `（读取异常：${readError}）` : ''}`
+              + '；可能是壳已换（旧 sessionId 残留）或持久日志未落盘。'
+              + '请用 taskline_list 取当前 sessionId 再试。',
+          };
+        }
+        return {
+          ok: true,
+          items: [],
+          state: 'empty',
+          title: (session && (session.title || session.name)) || '',
+          diagnosis: `读到 ${events.length} 个事件但无可展示正文`,
+        };
+      }
+      return { ok: true, items: items.slice(-limit), state: 'ok' };
+    },
+  }));
+
+  // —— taskline_archive ——
+  disposers.push(register({
+    name: 'taskline_archive',
+    description: '归档（或恢复）任务线：归档后从侧栏移除、群聊里进「已归档」，可恢复。'
+      + '**只用于一次性任务线 / 带「｜」分身**；常驻成员线（tasks.json 登记的正式成员）归档会被拒绝，'
+      + '确需换壳回收旧壳时显式传 force: true。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['session'],
+      properties: {
+        session: { type: 'string', description: 'sessionId 或标题' },
+        restore: { type: 'boolean', description: 'true = 取消归档' },
+        force: { type: 'boolean', description: 'true = 强制归档常驻成员线（仅限换壳回收旧壳等明确场景）' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok'],
+        properties: {
+          ok: { type: 'boolean' },
+          cleaned: { type: 'object' },
+          refused: { type: 'boolean' },
+          handoffPath: { type: 'string' },
+          handoffMessages: { type: 'number' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: !value.ok
+          ? `归档失败：${value.error}`
+          : `已完成归档操作${value.cleaned && value.cleaned.removedAvatar ? '；已清理该分身名的头像条目' : ''}`
+            + (value.cleaned && value.cleaned.removedFromMembers && value.cleaned.removedFromMembers.length
+              ? `；已从归档任务 ${value.cleaned.removedFromMembers.join(',')} 的 members 移除` : '')
+            + (value.handoffPath
+              ? `；交接档案已生成（${value.handoffMessages} 条 assistant 输出）：${value.handoffPath}`
+              : ''),
+      }],
+    },
+    async execute(args, exec) {
+      const registry = hub.get('workspaceRegistry');
+      const live = deps.resolveSession(args.session);
+      let sessionId = live && live.id;
+      let targetTitle = deps.titleOfSession(live) || '';
+      if (!sessionId) {
+        // 冷会话（重启后未激活）不在 sessions.list() 里：
+        // 用 sessionController.list() 兜底——id 精确匹配优先（同名新旧会话并存时按 id 无歧义）
+        try {
+          const controller = hub.get('sessionController');
+          const rows = controller && typeof controller.list === 'function'
+            ? await controller.list(new AbortController().signal) : [];
+          const arr = Array.isArray(rows) ? rows : (rows && Array.isArray(rows.items) ? rows.items : []);
+          const ref = String(args.session || '');
+          const byId = arr.find((r) => r && String(r.sessionId) === ref);
+          const byTitle = byId ? undefined : arr.find((r) => {
+            const t = r && r.projections && r.projections.values ? r.projections.values.title : '';
+            return typeof t === 'string' && t === ref;
+          });
+          const row = byId || byTitle;
+          if (row) {
+            sessionId = String(row.sessionId);
+            const pt = row && row.projections && row.projections.values ? row.projections.values.title : '';
+            if (!targetTitle && typeof pt === 'string') targetTitle = pt;
+          }
+        } catch (error) { /* 冷会话兜底失败 → 走原报错 */ }
+      }
+      if (!sessionId) return { ok: false, error: '找不到这个会话' };
+      if (!registry) return { ok: false, error: 'workspaceRegistry 不可用' };
+      // 2026-10-29 用户令「成员可自建分身并回收」——成员侧护栏：成员只能归档/恢复
+      // 「<本项目> · <本人父名>｜…」的分身；他人线 / 本体 / 常驻线一律拒（仍走管理者）。
+      // 管理者（Yat2/Hermes）与用户会话不受此限，原有常驻护栏继续生效。
+      {
+        const callerAgent = exec && exec.agent;
+        const callerTitle = callerAgent ? deps.callerTitleOf(callerAgent) : '';
+        if (callerTitle.includes(' · ') && !/ · (Yat2|Hermes)$/.test(callerTitle)) {
+          const callerProject = projectOfSessionTitle(callerTitle);
+          const callerRoleRaw = callerTitle.slice(callerTitle.lastIndexOf(' · ') + 3).trim();
+          const baseRole = callerRoleRaw.includes('｜')
+            ? callerRoleRaw.slice(0, callerRoleRaw.indexOf('｜')).trim() : callerRoleRaw;
+          const targetProject = projectOfSessionTitle(targetTitle);
+          const targetMember = agentNameOfTitle(targetTitle);
+          const isOwnClone = targetMember.includes('｜')
+            && targetMember.slice(0, targetMember.indexOf('｜')).trim() === baseRole
+            && targetProject === callerProject;
+          if (!isOwnClone) {
+            return {
+              ok: false,
+              error: `成员只能回收自己的分身（形如「${callerProject} · ${baseRole}｜…」）；`
+                + `「${targetTitle || sessionId}」不是你的分身。他人线/本体/常驻线请走管理者。`,
+            };
+          }
+        }
+      }
+      // 常驻成员护栏（2026-10-24「雨课堂被 Yat2 误归档」）：tasks.json 登记的正式成员线
+      // （无「｜」）默认拒绝归档——管理者只能归档一次性线/分身；确需换壳回收旧壳传 force。
+      if (!args.restore && args.force !== true) {
+        try {
+          const title = deps.titleOfSession(live) || '';
+          const registeredIds = readRegisteredSessionIds(hostRoot(hub));
+          if (registeredIds.has(String(sessionId)) && !title.includes('｜')) {
+            return {
+              ok: false,
+              refused: true,
+              error: `「${title || sessionId}」是 tasks.json 登记的常驻成员线，不做常规归档`
+                + '（做完回收只适用于一次性任务线 / 带「｜」的分身）。'
+                + '若确实要换壳回收旧壳，重试并显式传 force: true。',
+            };
+          }
+        } catch (error) { /* 护栏判定失败不挡归档 */ }
+      }
+      try {
+        if (args.restore) await registry.unarchiveSession(sessionId);
+        else {
+          await registry.archiveSession(sessionId, { stopActivity: true });
+          // 归档动作顺手触发清理（2026-10-24 用户令：不用定时器，超限删最旧）
+          await pruneArchivedSessions(hub).catch(() => {});
+        }
+      } catch (error) {
+        return { ok: false, error: String(error && error.message) };
+      }
+      // 归档分身时同步清理注册表（2026-10-22 用户要求）：
+      // 历次「成员｜具体任务」的分身名沉淀在 avatars 里，侧栏看起来像一堆细名本体。
+      let cleaned = null;
+      let handoff = null;
+      if (!args.restore) {
+        try {
+          const title = deps.titleOfSession(live) || '';
+          const project = projectOfSessionTitle(title);
+          const memberName = agentNameOfTitle(title);
+          if (project && memberName.includes('｜')) {
+            cleaned = cleanCloneRegistry(project, memberName, hostRoot(hub));
+            // 交接档案（2026-10-23）：分身归档后信息不能只埋在归档会话里，
+            // 机械抽取它的全部 assistant 输出落盘，供管理者/父 agent 事后 grep。
+            try {
+              // 2026-11-09 修「归档时 assistant 消息数=0，但答案其实已产出」：
+              // 实测 session-51e9dedd（「讲解已启用插件各自作用」）21:12:16 归档读到 0 条，
+              // 而它的 session.v4.jsonl.zstd 在 21:12:18 才落盘（263KB，内容齐全）——
+              // 归档动作早于持久化/内存 flush，于是交接档案空白。
+              // 修法：先读一次，若 0 条 assistant 就等 1.2s 重读（最多 2 次），
+              // 避免"回收早于产出"把分身成果丢掉。
+              let session = live || (hub.get('sessions') || {}).get?.(sessionId);
+              let events = await collectEvents(hub, session, sessionId);
+              const countAssistant = (list) => (Array.isArray(list) ? list : [])
+                .filter((e) => e && e.type === 'assistant/message').length;
+              for (let attempt = 0; attempt < 2 && countAssistant(events) === 0; attempt += 1) {
+                await new Promise((r) => setTimeout(r, 1200));
+                session = live || (hub.get('sessions') || {}).get?.(sessionId);
+                events = await collectEvents(hub, session, sessionId);
+                console.warn(`[hub-desktop-ui] clone handoff empty, retried (attempt ${attempt + 1}) session=${sessionId}`);
+              }
+              handoff = writeCloneHandoff(project, memberName, sessionId, title, events, hostRoot(hub));
+              if (!handoff.ok) {
+                console.warn(`[hub-desktop-ui] clone handoff failed: ${String(handoff.error)}`);
+              }
+            } catch (error) {
+              handoff = { ok: false, error: String((error && error.message) || error) };
+              console.warn(`[hub-desktop-ui] clone handoff threw: ${String(error)}`);
+            }
+          }
+        } catch (error) {
+          cleaned = { ok: false, error: String((error && error.message) || error) };
+        }
+      }
+      // 只在真的清理过（或明确失败）时才带 cleaned 字段——undefined 会让输出校验失败
+      const result = { ok: true };
+      if (cleaned && typeof cleaned === 'object') {
+        result.cleaned = {
+          removedAvatar: Boolean(cleaned.removedAvatar),
+          removedFromMembers: Array.isArray(cleaned.removedFromMembers) ? cleaned.removedFromMembers : [],
+          ...(cleaned.ok === false ? { error: String(cleaned.error || 'cleanup failed') } : {}),
+        };
+      }
+      if (handoff && handoff.ok && handoff.path) {
+        result.handoffPath = String(handoff.path);
+        result.handoffMessages = Number(handoff.assistantMessages) || 0;
+      }
+      return result;
+    },
+  }));
+
+  // —— taskline_rename ——
+  disposers.push(register({
+    name: 'taskline_rename',
+    description: '给任务线（会话）改标题，标题会直接显示在侧栏和群聊卡片上。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['session', 'title'],
+      properties: {
+        session: { type: 'string', description: 'sessionId 或当前标题' },
+        title: { type: 'string', description: '新标题，建议「<项目> · <成员>」' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok'],
+        properties: {
+          ok: { type: 'boolean' },
+          title: { type: 'string' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => [{ type: 'text', text: value.ok ? `已改名：${value.title}` : `改名失败：${value.error}` }],
+    },
+    async execute(args) {
+      const controller = hub.get('sessionController');
+      let session = deps.resolveSession(args.session);
+      // 冷会话回退（2026-10-27 修「找不到这个会话」）：deps.resolveSession 只查 sessions.list()
+      // （live 会话），冷/重启后会话不在其中。这里照 taskline_prompt 的做法查
+      // controller.list() 全量底册——精确 id 优先，其次精确标题（同对多个标题不猜，报歧义）。
+      if (!session && controller && typeof controller.list === 'function') {
+        try {
+          const value = await controller.list(new AbortController().signal);
+          const rows = value && Array.isArray(value.items) ? value.items : (Array.isArray(value) ? value : []);
+          const registry = hub.get('workspaceRegistry');
+          const archivedSet = new Set(
+            registry && Array.isArray(registry.archivedSessionIds)
+              ? registry.archivedSessionIds.map(String) : [],
+          );
+          const ref = String(args.session || '').trim();
+          const active = rows.filter((row) => row && row.sessionId
+            && !archivedSet.has(String(row.sessionId)));
+          const titleOf = (row) => (row.projections && row.projections.values
+            && typeof row.projections.values.title === 'string'
+            ? row.projections.values.title : '');
+          const byId = active.find((row) => String(row.sessionId) === ref);
+          if (byId) {
+            session = { id: String(byId.sessionId), displayTitle: titleOf(byId) };
+          } else {
+            const byTitle = active.filter((row) => titleOf(row) === ref);
+            if (byTitle.length === 1) {
+              session = { id: String(byTitle[0].sessionId), displayTitle: titleOf(byTitle[0]) };
+            } else if (byTitle.length > 1) {
+              return { ok: false, error: `同名多个会话：${byTitle.map((r) => `${titleOf(r)} ${r.sessionId}`).join('；')}（请传完整 sessionId）` };
+            }
+          }
+        } catch { /* 回退失败走原错误 */ }
+      }
+      if (!session) return { ok: false, error: '找不到这个会话（冷会话请传完整 sessionId，用 taskline_list 查）' };
+      try {
+        await controller.rename({ sessionId: session.id, title: args.title });
+        // 改完立刻对账：若与新标题撞名的另一条还在活跃集合里，把非官方那条改「（旧壳 MM-DD）」
+        dedupeActiveTitles(hub).catch(() => {});
+        return { ok: true, title: args.title };
+      } catch (error) {
+        return { ok: false, error: String(error && error.message) };
+      }
+    },
+  }));
+
+  // —— resume_session ——
+  disposers.push(register({
+    name: 'resume_session',
+    description: '让指定会话从断点续跑（发一条【续跑】提示，绕过 24h 自动续跑账本）。用于重启后没被自动续跑、或需要强制推进的会话。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['session'],
+      properties: {
+        session: { type: 'string', description: '目标会话的 sessionId 或标题（可部分匹配）' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok'],
+        properties: { ok: { type: 'boolean' }, resumed: { type: 'array', items: { type: 'string' } }, error: { type: 'string' } },
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: value.ok
+          ? `已续跑 ${value.resumed.length} 个会话：${value.resumed.join('、') || '（无匹配）'}`
+          : `续跑失败：${value.error || 'unknown'}`,
+      }],
+    },
+    async execute(args) {
+      try {
+        const result = await resumeInterruptedSessions(hub, { force: true, only: String(args.session || ''), max: 1 });
+        return { ok: true, resumed: result.resumed };
+      } catch (error) {
+        return { ok: false, error: String(error && error.message) };
+      }
+    },
+  }));
+
+  // —— taskline_goal_status ——
+  disposers.push(register({
+    name: 'taskline_goal_status',
+    description: '查某个会话当前的 goal（标题 / 状态 / 轮次）。派活带 goal 后用它核验是否真的建进会话。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['session'],
+      properties: {
+        session: { type: 'string', description: '目标会话的 sessionId 或标题（可部分匹配）' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok'],
+        properties: {
+          ok: { type: 'boolean' },
+          sessionId: { type: 'string' },
+          title: { type: 'string' },
+          hasGoal: { type: 'boolean' },
+          objective: { type: 'string' },
+          phase: { type: 'string' },
+          roundsStarted: { type: 'number' },
+          maxGoalRounds: { type: 'number' },
+          goalId: { type: 'string' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: !value.ok
+          ? `查询失败：${value.error || 'unknown'}`
+          : value.hasGoal
+            ? `「${value.title || value.sessionId}」goal=[${value.phase}] ${value.objective}（轮次 ${value.roundsStarted}/${value.maxGoalRounds}）`
+            : `「${value.title || value.sessionId}」当前没有 goal`,
+      }],
+    },
+    async execute(args) {
+      const ref = String(args.session || '').trim();
+      const isExactId = /^session-[0-9a-f-]{20,}$/i.test(ref);
+      let session = isExactId ? (hub.get('sessions') && hub.get('sessions').get(ref)) : deps.resolveSession(ref);
+      if (!session && isExactId) session = { id: ref };
+      if (!session) return { ok: false, error: '找不到这个会话' };
+      const goalsSvc = hub.get('goals') || (typeof ctx.get === 'function' ? ctx.get('goals') : undefined);
+      const agentsSvc = hub.get('agents');
+      const agent = agentsSvc && typeof agentsSvc.get === 'function' ? agentsSvc.get(String(session.id)) : undefined;
+      if (!goalsSvc || typeof goalsSvc.get !== 'function') return { ok: false, error: 'goal 服务（ctx.goals）不可用' };
+      if (!agent || !agent.session) return { ok: false, sessionId: String(session.id), title: deps.titleOfSession(session), hasGoal: false, error: 'agent 未激活（冷会话需先唤醒）' };
+      try {
+        const view = goalsSvc.get(agent);
+        const goal = view && (view.goal || view);
+        if (!goal || !goal.id) {
+          return { ok: true, sessionId: String(session.id), title: deps.titleOfSession(session), hasGoal: false, error: '' };
+        }
+        return {
+          ok: true,
+          sessionId: String(session.id),
+          title: deps.titleOfSession(session),
+          hasGoal: true,
+          goalId: String(goal.id || ''),
+          objective: String(goal.objective || ''),
+          phase: String(goal.phase || ''),
+          roundsStarted: Number(goal.roundsStarted) || 0,
+          maxGoalRounds: Number(goal.maxGoalRounds) || 0,
+          error: '',
+        };
+      } catch (error) {
+        return { ok: false, sessionId: String(session.id), error: String((error && error.message) || error) };
+      }
+    },
+  }));
+
+  // —— taskline_wait ——
+  disposers.push(register({
+    name: 'taskline_wait',
+    description: '例外工具（默认派完即转下一任务，不等成员）：仅当用户要当场闭环结论时才用。'
+      + '等成员状态变化（不轮询）：运行中→空闲或有新消息就返回；没有目标在跑立刻 noProgress。timeoutMs 建议 ≤60000。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: [],
+      properties: {
+        session: { type: 'string', description: '单个目标：sessionId 或标题（可部分匹配）' },
+        sessionIds: {
+          type: 'array',
+          items: { type: 'string' },
+          description: '多个目标：sessionId 或标题片段。session 与 sessionIds 都不给 = 等任意成员（除调用者自己）',
+        },
+        timeoutMs: { type: 'number', description: '最长等待毫秒，默认 120000，上限 600000' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['status', 'waitedMs'],
+        properties: {
+          status: { type: 'string', enum: ['changed', 'noProgress', 'timeout'] },
+          waitedMs: { type: 'number' },
+          changed: {
+            type: 'array',
+            items: {
+              type: 'object',
+              additionalProperties: false,
+              required: ['sessionId', 'title', 'idle'],
+              properties: {
+                sessionId: { type: 'string' },
+                title: { type: 'string' },
+                idle: { type: 'boolean' },
+              },
+            },
+          },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => {
+        if (value.status === 'changed') {
+          const list = (value.changed || [])
+            .map((item) => `${item.title || item.sessionId}${item.idle ? ' [已空闲]' : ' [有新消息]'}`)
+            .join('、');
+          return [{ type: 'text', text: `成员状态有变化（等了 ${value.waitedMs}ms）：${list || '（无）'}` }];
+        }
+        if (value.status === 'noProgress') {
+          return [{ type: 'text', text: `没有目标在运行，立刻返回 noProgress（${value.waitedMs}ms）${value.error ? `\n${value.error}` : ''}` }];
+        }
+        return [{ type: 'text', text: `等待超时（${value.waitedMs}ms）：目标仍无变化${value.error ? `\n${value.error}` : ''}` }];
+      },
+    },
+    async execute(args, exec) {
+      const startedAt = Date.now();
+      const sessionsSvc = hub.get('sessions');
+      const liveList = sessionsSvc && typeof sessionsSvc.list === 'function' ? sessionsSvc.list() : [];
+      const callerId = exec && exec.agent && exec.agent.id !== undefined ? String(exec.agent.id) : '';
+      const registry = hub.get('workspaceRegistry');
+      const archivedSet = new Set(
+        registry && Array.isArray(registry.archivedSessionIds) ? registry.archivedSessionIds.map(String) : [],
+      );
+      const titleOfId = (id) => {
+        const live = liveList.find((session) => String(session.id) === String(id));
+        return live ? deps.titleOfSession(live) : '';
+      };
+      // 解析目标：显式 ref 优先，都不给 = 任意成员（排除调用者自己——它正在跑本次调用）
+      const refs = [];
+      if (args.session) refs.push(String(args.session).trim());
+      if (Array.isArray(args.sessionIds)) {
+        for (const ref of args.sessionIds) {
+          const text = String(ref || '').trim();
+          if (text) refs.push(text);
+        }
+      }
+      const targetIds = new Set();
+      const unknown = [];
+      if (refs.length === 0) {
+        for (const session of liveList) {
+          const id = String(session.id);
+          if (id === callerId || archivedSet.has(id)) continue;
+          targetIds.add(id);
+        }
+      } else {
+        for (const ref of refs) {
+          if (/^session-[0-9a-f-]{20,}$/i.test(ref)) {
+            targetIds.add(ref);
+            continue;
+          }
+          const hits = liveList.filter((session) => {
+            const title = deps.titleOfSession(session);
+            return title === ref || title.includes(ref);
+          });
+          if (hits.length === 0) unknown.push(ref);
+          else for (const session of hits) targetIds.add(String(session.id));
+        }
+      }
+      const unknownNote = unknown.length ? `找不到会话：${unknown.join(' / ')}` : '';
+      if (targetIds.size === 0) {
+        return { status: 'noProgress', waitedMs: Date.now() - startedAt, ...(unknownNote ? { error: unknownNote } : {}) };
+      }
+      // 没有目标在跑 → 不等待，立刻返回（验收 a）
+      const runningIds = [...targetIds].filter((id) => deps.isRunningNow(id));
+      if (runningIds.length === 0) {
+        return { status: 'noProgress', waitedMs: Date.now() - startedAt, ...(unknownNote ? { error: unknownNote } : {}) };
+      }
+      const requested = Number(args.timeoutMs);
+      const timeoutMs = Number.isFinite(requested) && requested > 0
+        ? Math.min(Math.max(Math.floor(requested), 1000), 600000)
+        : 120000;
+
+      const outcome = await new Promise((finishWait) => {
+        let settled = false;
+        let offStatus;
+        let offSession;
+        let timer;
+        const idleChanged = () => [...targetIds]
+          .filter((id) => !deps.isRunningNow(id))
+          .map((id) => ({ sessionId: id, title: titleOfId(id), idle: true }));
+        const cleanup = () => {
+          if (timer) clearTimeout(timer);
+          for (const off of [offStatus, offSession]) {
+            if (typeof off === 'function') {
+              try { off(); } catch (error) { /* ignore */ }
+            }
+          }
+        };
+        const settle = (value) => {
+          if (settled) return;
+          settled = true;
+          cleanup();
+          finishWait({ ...value, waitedMs: Date.now() - startedAt });
+        };
+        timer = setTimeout(() => settle({ status: 'timeout' }), timeoutMs);
+        if (timer && typeof timer.unref === 'function') timer.unref();
+        // 1) 官方运行状态事件：目标 running → false 即返回
+        offStatus = hub.on('api-session/status', (changedId, running) => {
+          try {
+            const key = String(changedId);
+            if (!targetIds.has(key) || running) return;
+            settle({ status: 'changed', changed: idleChanged() });
+          } catch (error) { /* ignore */ }
+        });
+        // 2) 会话事件：回合结束（且确实空闲）或新用户消息也算「有变化」
+        offSession = hub.on('session/event', (session, event) => {
+          try {
+            const key = session && session.id !== undefined ? String(session.id) : '';
+            if (!targetIds.has(key) || !event) return;
+            const type = String(event.type || '');
+            const sourceKind = event.data && event.data.source ? event.data.source.kind : undefined;
+            const freshUserMessage = type === 'user/message'
+              && (!sourceKind || sourceKind === 'user');
+            if (type !== 'turn/end' && !freshUserMessage) return;
+            const idle = idleChanged();
+            if (idle.length > 0) {
+              settle({ status: 'changed', changed: idle });
+              return;
+            }
+            if (freshUserMessage) {
+              settle({ status: 'changed', changed: [{ sessionId: key, title: titleOfId(key), idle: false }] });
+            }
+          } catch (error) { /* ignore */ }
+        });
+        // 3) 调用方取消（用户点停止）：不悬挂，清理监听后按取消返回
+        const signal = exec && exec.signal;
+        if (signal && typeof signal.addEventListener === 'function') {
+          if (signal.aborted) {
+            settle({ status: 'timeout', error: 'aborted' });
+            return;
+          }
+          signal.addEventListener('abort', () => settle({ status: 'timeout', error: 'aborted' }), { once: true });
+        }
+        // 4) 竞态兜底：目标可能在「检查 running」与「挂监听」之间就已经变 idle，
+        //    挂完监听再读一次真实状态，别白等到超时。
+        const alreadyIdle = idleChanged();
+        if (alreadyIdle.length > 0) settle({ status: 'changed', changed: alreadyIdle });
+      });
+      return unknownNote ? { ...outcome, error: outcome.error || unknownNote } : outcome;
+    },
+  }));
+
+  // —— taskline_create ——
+  disposers.push(register({
+    name: 'taskline_create',
+    description: '新建一条任务线：创建一个新会话并命名（可选立刻给它派第一条任务）。\n'
+      + '**任务书里必须带「用户可见验收」段**（§20，2026-11-10 用户令）：'
+      + '写清用户能**直接看/点/复制**的验收物——截图、可打开的文件或 URL、一段可粘贴的输出——'
+      + '而不是「测试通过 / 已自测」这类自证。模板：\n'
+      + '【验收（用户可见）】①<可打开的产物路径或 URL>；②<用户一条命令能复现的输出>；'
+      + '③<若涉及重启，写清重启后一步核验的方法>。\n'
+      + '**不写自证式验收（"单测通过""逻辑正确"）**：验收物必须由用户侧可见，审核者据此判定完成。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['title'],
+      properties: {
+        title: { type: 'string', description: '新任务线标题，建议「<项目> · <成员>」' },
+        text: {
+          type: 'string',
+          description: '可选的初始任务内容。**必须含「【验收（用户可见）】」段**：'
+            + '列出用户可直接看/点/复制的验收物（产物路径或 URL、可复现命令与输出、重启后一步核验法），'
+            + '禁止只写「测试通过」「已自测」等自证。',
+        },
+        preset: { type: 'string', description: '可选的 agent preset，默认 cordis（Creator mode）' },
+        project: { type: 'string', description: '所属项目名，默认从 title 的「 · 」前解析' },
+        avatar: { type: 'string', description: '头像 emoji，可不填（自动从候选池分配一个未被占用的）' },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok'],
+        properties: {
+          ok: { type: 'boolean' },
+          sessionId: { type: 'string' },
+          title: { type: 'string' },
+          avatar: { type: 'string' },
+          warning: { type: 'string' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: value.ok
+          ? `已建任务线：${value.title}（${value.sessionId}）${value.warning ? `\n⚠️ ${value.warning}` : ''}`
+          : `新建失败：${value.error}`,
+      }],
+    },
+    async execute(args, exec) {
+      // 2026-10-29 用户令「每个 agent 多线任务时可自建分身并回收」——成员侧护栏：
+      // 成员（标题「项目 · 角色」且非管理者）只能建「<本项目> · <本人父名>｜<任务短语>」
+      // 的分身；裸名本体 / 别人的分身 / 跨项目一律拒，仍走管理者。管理者/用户会话不受限。
+      const callerAgent = exec && exec.agent;
+      const callerTitle = callerAgent ? deps.callerTitleOf(callerAgent) : '';
+      if (callerTitle.includes(' · ') && !/ · (Yat2|Hermes)$/.test(callerTitle)) {
+        const callerProject = projectOfSessionTitle(callerTitle);
+        const callerRoleRaw = callerTitle.slice(callerTitle.lastIndexOf(' · ') + 3).trim();
+        // 分身再开子分身时按父名认亲（「DSH工程师｜a」开的也必须是「DSH工程师｜…」）
+        const baseRole = callerRoleRaw.includes('｜')
+          ? callerRoleRaw.slice(0, callerRoleRaw.indexOf('｜')).trim() : callerRoleRaw;
+        const wantMember = args.title.includes(' · ')
+          ? args.title.slice(args.title.lastIndexOf(' · ') + 3).trim() : args.title.trim();
+        const wantProject = args.project || (args.title.includes(' · ')
+          ? args.title.slice(0, args.title.indexOf(' · ')).trim() : callerProject);
+        const wantParent = wantMember.includes('｜')
+          ? wantMember.slice(0, wantMember.indexOf('｜')).trim() : '';
+        if (!wantMember.includes('｜') || wantParent !== baseRole || wantProject !== callerProject) {
+          return {
+            ok: false,
+            error: `成员只能自建分身：标题形如「${callerProject} · ${baseRole}｜<任务短语>」`
+              + `（父名必须是本人、项目必须是本项目）。建本体 / 他人分身 / 跨项目仍需管理者。`,
+          };
+        }
+      }
+      const controller = hub.get('sessionController');
+      if (!controller || typeof controller.create !== 'function') return { ok: false, error: 'sessionController 不可用' };
+      try {
+        // 命名校验前置（2026-10-23 用户令；2026-10-26 三改）：必须发生在 controller.create **之前**，
+        // 否则违规名被拒时会话已建出来，留孤儿。
+        // 2026-10-26 用户新规则——校验分两路：
+        //   A. 带「｜」→ **分身**路：形如「<父名>｜<任务短语>」（如 DSH工程师｜切换提速）。
+        //      父名须是本项目已存在的成员；任务短语非空即过（2 字以上更佳但不强制）；
+        //      「｜副手/｜二号」不再特殊，也是合法分身名；**无数量上限，完成即归档回收**。
+        //   B. 不带「｜」→ **本体**路：旧规则全保留——拒裸宽泛词（工程师/专家/管家…），
+        //      任务型名字给警告不拒绝。
+        const memberName = args.title.includes(' · ') ? args.title.slice(args.title.lastIndexOf(' · ') + 3).trim() : args.title.trim();
+        const projectNameEarly = args.project || (args.title.includes(' · ') ? args.title.slice(0, args.title.indexOf(' · ')).trim() : '');
+        const BARE_ROLE_WORDS = ['工程师', '专家', '管家', '助手', '成员', '分析师', '设计师', '研究员', 'agent', 'Agent'];
+        let nameWarning = '';
+        if (memberName.includes('｜')) {
+          const barAt = memberName.indexOf('｜');
+          const parentName = memberName.slice(0, barAt).trim();
+          const taskPhrase = memberName.slice(barAt + 1).trim();
+          if (!parentName) {
+            return { ok: false, error: `「${memberName}」缺父名——分身名形如「<父名>｜<任务短语>」（如 DSH工程师｜切换提速）` };
+          }
+          if (!taskPhrase) {
+            return { ok: false, error: `「${memberName}」缺任务短语——分身名形如「<父名>｜<任务短语>」（如 DSH工程师｜切换提速）` };
+          }
+          // 父名须是本项目已存在的成员（防拼错父名造出野分身）
+          if (projectNameEarly) {
+            const row = readTaskFile(projectNameEarly, hostRoot(hub));
+            const raw = row && row.tasks && typeof row.tasks === 'object' && !Array.isArray(row.tasks) ? row.tasks : {};
+            const tasksList = Array.isArray(raw.tasks) ? raw.tasks : [];
+            const sessionsMap = raw.memberSessions && typeof raw.memberSessions === 'object' ? raw.memberSessions : {};
+            const known = new Set(Object.keys(sessionsMap));
+            for (const task of tasksList) {
+              for (const name of (Array.isArray(task && task.members) ? task.members : [])) known.add(String(name));
+            }
+            if (known.size > 0 && !known.has(parentName)) {
+              return {
+                ok: false,
+                error: `分身父名「${parentName}」不是项目「${projectNameEarly}」的已登记成员（候选：${[...known].slice(0, 8).join(' / ')}）——先有本体成员，再挂分身`,
+              };
+            }
+            // 2026-11-09 用户令（父名错第二次）：分诊建线时父名必须是**被分诊线的成员**，
+            // 不是分诊者自己。分诊者通常是管理者 Yat2 → 会建出「Yat2｜<UI 开发任务>」，
+            // 让管理者名下堆交付物线（违反「管理者不产出交付物」）。工具层直接拦。
+            if (parentName === 'Yat2' && known.size > 1) {
+              const executors = [...known].filter((x) => x !== 'Yat2');
+              return {
+                ok: false,
+                error: `父名不能用管理者「Yat2」——这条线该由真实执行成员挂：${executors.slice(0, 6).join(' / ')}`
+                  + '（用户令 2026-11-09：分诊建的线父名必须是**被分诊线的成员**，不是分诊者自己；管理者不产出交付物）',
+              };
+            }
+          }
+          // 分身名 = 任务短语，天然任务导向，不再触发 looksTaskSpecificName 警告
+        } else {
+          if (BARE_ROLE_WORDS.includes(memberName)) {
+            return {
+              ok: false,
+              error: `「${memberName}」是裸宽泛角色名，禁止使用——请带领域前缀（如 DSH工程师 / 视网膜专家 / 出题工程师）`,
+            };
+          }
+          if (looksTaskSpecificName(memberName)) {
+            nameWarning = `「${memberName}」像是具体任务名——常驻本体建议起正式角色名（职责导向）；**按任务开线请用分身**：「<父名>｜<任务短语>」（完成即归档回收）`;
+          }
+        }
+        const created = await controller.create({ cwd: hostRoot(hub), agentPreset: args.preset || defaultPreset });
+        const sessionId = created && created.sessionId;
+        if (!sessionId) return { ok: false, error: '创建未返回 sessionId' };
+        await controller.rename({ sessionId, title: args.title });
+        const projectName = projectNameEarly;
+        const assignedAvatar = projectName ? ensureMemberAvatar(projectName, memberName, hostRoot(hub), args.avatar) : '';
+        // 2026-10-26：头像登记失败不再静默——告诉 Yat2 当场补（韩明明论文·论文写手
+        // 漏头像就是写错根 + 静默失败叠加的结果，排查靠人眼）
+        const avatarWarning = projectName && !assignedAvatar
+          ? `头像未登记（${projectName}/tasks.json 或全局 avatars.json 写入失败）——建完后请检查并手工补 .hub/avatars.json`
+          : '';
+        if (args.text) {
+          await controller.prompt({
+            requestId: `hub-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            sessionId,
+            mode: 'queue',
+            content: [{ type: 'text', text: args.text }],
+          }, new AbortController().signal);
+        }
+        return {
+          ok: true, sessionId, title: args.title,
+          // 2026-10-29：lossless JSON 不认 undefined 值（头像池空时报 invalid output）——改为条件展开
+          ...(assignedAvatar ? { avatar: assignedAvatar } : {}),
+          ...(([nameWarning, avatarWarning].filter(Boolean).join('；')) ? { warning: [nameWarning, avatarWarning].filter(Boolean).join('；') } : {}),
+        };
+      } catch (error) {
+        return { ok: false, error: String(error && error.message) };
+      }
+    },
+  }));
+
+  // —— taskline_prompt ——
+  disposers.push(register({
+    name: 'taskline_prompt',
+    description: '给指定的任务线（会话）派活：按 sessionId 或会话标题找到它，发一条消息。用于分派、催办、重启任务线。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['session', 'text'],
+      properties: {
+        session: { type: 'string', description: '目标会话的 sessionId 或标题（可部分匹配）' },
+        text: {
+          type: 'string',
+          description: '要发给它的话，写清任务与验收标准。'
+            + '**验收必须是「用户可见验收」**（§20）：给出用户能直接看/点/复制的验收物'
+            + '（产物路径或 URL、可复现命令及输出、重启后一步核验法），'
+            + '不要写「测试通过」「已自测」这类自证；模板见 taskline_create。',
+        },
+        goal: {
+          type: 'string',
+          description: '本线目标（一句话、交付物导向）。传了会写进 tasks.json 的 goal 并把目标化指令插到 prompt 最前面；不传保持原行为',
+        },
+        task: {
+          type: 'string',
+          description: '任务线 id（如 client-ui / quota-panel）。同一成员属于多条线时必须传，否则写 goal 会因歧义被拒绝并返回候选列表',
+        },
+        mode: {
+          type: 'string',
+          enum: ['triage', 'queue', 'steer', 'interrupt'],
+          description: '投递方式，默认 triage（2026-11-08 用户令：排队不再干等）。'
+            + 'triage = 目标在跑时**不排队**，立刻开一条「<成员>｜queue分诊」分身：它读主线上下文后判定'
+            + '「纠偏/补充/紧急 → steer 进主线当前轮」还是「独立新任务 → 分身自己做」，给出交接摘要后插件自动归档回收；'
+            + '目标空闲时退化为 queue（直接起一轮，不开分身）；'
+            + 'queue = 老行为，真排队等它跑完当前轮（仅当你明确要「等它跑完」时用）；'
+            + 'steer = 目标在跑时在下一个 step 边界把消息插进当前轮（不打断正在执行的工具调用），目标空闲时自动退化为 queue；'
+            + 'interrupt = 中断目标当前这一轮但保留已排队的后续消息（本条排进队列，等下次唤醒按序处理）',
+        },
+        timeoutMs: {
+          type: 'number',
+          description: `仅 interrupt 用：等目标变 idle 的上限毫秒，默认 ${INTERRUPT_IDLE_WAIT_MS}。`
+            + 'abort 慢于该值时返回 idle:false，但 interrupted:true 且已排队消息已保留（按 interrupted 判定中断成功即可）',
+        },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['ok'],
+        properties: {
+          ok: { type: 'boolean' },
+          sessionId: { type: 'string' },
+          title: { type: 'string' },
+          goal: { type: 'string' },
+          goalTaskId: { type: 'string' },
+          goalError: { type: 'string' },
+          goalWritten: { type: 'boolean' },
+          goalCreated: { type: 'boolean' },
+          goalFailed: { type: 'string' },
+          goalMatchedBy: { type: 'string' },
+          candidates: { type: 'array', items: { type: 'string' } },
+          crossProject: { type: 'boolean' },
+          callerProject: { type: 'string' },
+          targetProject: { type: 'string' },
+          mode: { type: 'string' },
+          interrupted: { type: 'boolean' },
+          idle: { type: 'boolean' },
+          textQueued: { type: 'boolean' },
+          // 派活纪律（2026-10-26）：目标运行状态与排队位次（工具层强制回传）
+          targetRunning: { type: 'boolean' },
+          pendingDispatches: { type: 'number' },
+          queuedBefore: { type: 'number' },
+          // queue 分诊（2026-11-08）：不排队，改开分诊分身
+          triageSessionId: { type: 'string' },
+          triageTitle: { type: 'string' },
+          // 唯一投递结论（2026-11-09）：triage / steer / queued / interrupted / started
+          delivery: { type: 'string' },
+          note: { type: 'string' },
+          error: { type: 'string' },
+        },
+      },
+      // 2026-11-09：render 抽成纯函数（同一返回只允许一个结论；回归用例直接断言它）
+      render: (_args, value) => [{ type: 'text', text: renderTasklinePrompt(value) }],
+    },
+    async execute(args, exec) {
+      const controller = hub.get('sessionController');
+      if (!controller || typeof controller.prompt !== 'function') return { ok: false, error: 'sessionController 不可用' };
+      // P8-①（2026-10-29）：text 缺失/非字符串时**拒绝投递**并报错——此前 args.text 为
+      // undefined 会拼出字面 "undefined" 空消息投给成员（骨髓·单细胞师/生信分析师 10-29
+      // 16:52、16:55 各两连发）。宁可报错重发，不可投递垃圾轮。
+      if (typeof args.text !== 'string' || !args.text.trim()) {
+        return {
+          ok: false,
+          error: '缺少 text（收到 undefined/空/非字符串）。请检查 taskline_prompt 调用参数后重发；本条未投递。',
+        };
+      }
+      const ref = String(args.session || '').trim();
+      const isExactId = /^session-[0-9a-f-]{20,}$/i.test(ref);
+      let session = deps.resolveSession(ref);
+      // —— 同名歧义防护（重建后旧壳陷阱，DSH sync工程师 案例）——
+      // 标题寻址时：只有「唯一 live 命中，且不存在其它同名（冷/归档）」才直接投；
+      // 否则不静默投递，列出全部候选（id 尾 8 位 + 状态）让管理者用完整 sessionId 指定。
+      if (!isExactId) {
+        const liveSvc = hub.get('sessions');
+        const liveAll = liveSvc && typeof liveSvc.list === 'function' ? liveSvc.list() : [];
+        const liveHits = liveAll.filter((s) => {
+          const t = deps.titleOfSession(s);
+          return t === ref || t.includes(ref);
+        });
+        const registry = hub.get('workspaceRegistry');
+        const archivedSet = new Set(
+          registry && Array.isArray(registry.archivedSessionIds) ? registry.archivedSessionIds.map(String) : [],
+        );
+        const candidates = liveHits.map((s) => ({
+          id: String(s.id),
+          title: deps.titleOfSession(s),
+          state: archivedSet.has(String(s.id)) ? 'archived' : 'live',
+        }));
+        const seen = new Set(candidates.map((c) => c.id));
+        // 冷/归档同名候选也纳入清点（controller.list 是全量底册）
+        try {
+          const rows = await controller.list(new AbortController().signal);
+          const arr = Array.isArray(rows) ? rows : (rows && Array.isArray(rows.items) ? rows.items : []);
+          for (const row of arr) {
+            if (!row || !row.sessionId) continue;
+            const id = String(row.sessionId);
+            const t = row.projections && row.projections.values && typeof row.projections.values.title === 'string'
+              ? row.projections.values.title : '';
+            if (!t || !t.includes(ref)) continue;
+            if (seen.has(id)) continue;
+            seen.add(id);
+            candidates.push({ id, title: t, state: archivedSet.has(id) ? 'archived' : 'cold' });
+          }
+        } catch { /* 底册列不全就只按 live 候选判 */ }
+        if (candidates.length !== 1) {
+          return {
+            ok: false,
+            error: `「${ref}」命中 ${candidates.length} 个会话（${candidates.length === 0
+              ? '一个都没找到'
+              : candidates.map((c) => `${c.title} ${c.id} [${c.state}]`).join(' ; ')}）——`
+              + `会话重建后旧壳可能还在，请用 taskline_list 确认后传完整 sessionId 投递`,
+          };
+        }
+        session = liveHits[0];
+      }
+      if (!session) {
+        // 冷会话兜底：resolveAgent 会把它 resume 成活会话
+        //（SessionController.prompt 内部对 sessionId 走的就是 resolveAgent 同一条路）。
+        const agentsCtl = controller.agents;
+        if (agentsCtl && typeof agentsCtl.resolveAgent === 'function') {
+          try {
+            const found = await agentsCtl.resolveAgent(String(args.session));
+            if (found && found.agent) {
+              const resumedId = found.agent.session && found.agent.session.id ? found.agent.session.id : String(args.session);
+              const live = hub.get('sessions');
+              session = (live && typeof live.get === 'function' ? live.get(resumedId) : undefined)
+                || { id: resumedId };
+              console.log(`[hub-desktop-ui] taskline_prompt resumed cold session ${resumedId}`);
+            }
+          } catch (error) {
+            console.warn(`[hub-desktop-ui] cold resume failed: ${String(error)}`);
+          }
+        }
+      }
+      if (!session) return { ok: false, error: '找不到这个会话（先用 taskline_list 看 id；冷会话要传完整 sessionId）' };
+      // —— 项目边界护栏（2026-10-22 用户规则）——
+      // 每个项目的 agent 只能给本项目成员派活；跨项目直派会让群聊/侧栏出现
+      // 本项目看不见的成员（Book 的 Yat2 直派「应用开发 · DSH工程师」案例）。
+      // 工具层硬拒，不依赖管理者记住协议。exec.agent = 调用方（tools 服务注入）。
+      try {
+        const callerAgent = exec && exec.agent;
+        const callerTitle = callerAgent ? deps.callerTitleOf(callerAgent) : '';
+        const callerProject = projectOfSessionTitle(callerTitle);
+        const targetProject = projectOfSessionTitle(deps.titleOfSession(session));
+        if (callerProject && targetProject && targetProject !== callerProject) {
+          const targetName = agentNameOfTitle(deps.titleOfSession(session)) || deps.titleOfSession(session);
+          return {
+            ok: false,
+            crossProject: true,
+            callerProject,
+            targetProject,
+            error: `跨项目派活被拒：你属于「${callerProject}」，目标「${targetName}」属于「${targetProject}」。`
+              + `想用它的能力：先用 taskline_create 在本项目复制该成员（标题「${callerProject} · ${targetName}」，`
+              + `头像沿用它在「${targetProject}」tasks.json 里已有的 emoji，身份写明"从 ${targetProject} 借调"），再派活。`,
+          };
+        }
+      } catch (error) {
+        console.warn(`[hub-desktop-ui] project-boundary check failed: ${String(error)}`);
+      }
+      // 目标化派活（B）：写 tasks.json 的 goal + 在 prompt 最前面插目标化指令。
+      // 写回失败不影响投递（只在返回值里告警），因为投递本身是主目的。
+      let goalNote = '';
+      let goalTaskId = '';
+      let goalError = '';
+      let goalMatchedBy = '';
+      let goalCandidates = [];
+      let goalCreated = false;
+      let goalCreateError = '';
+      const goalText = String(args.goal || '').trim();
+      if (goalText) {
+        try {
+          const project = projectOfSessionTitle(deps.titleOfSession(session));
+          const agentName = agentNameOfTitle(deps.titleOfSession(session));
+          if (project) {
+            // 传了 task 就精确写那条线；没传时：setTaskGoal 在「同一成员属于多条线」时返回
+            // ambiguous + candidates（2026-10-22 用户纠正）；且**已有 goal 时拒绝覆盖**（P12-③）。
+            const wrote = setTaskGoal(
+              project, String(session.id), agentName, goalText, hostRoot(hub), String(args.task || ''),
+            );
+            if (wrote.ok) {
+              goalTaskId = wrote.taskId || '';
+              goalMatchedBy = wrote.matchedBy || '';
+            } else {
+              goalError = wrote.error || 'unknown';
+              if (Array.isArray(wrote.candidates)) goalCandidates = wrote.candidates;
+            }
+          } else {
+            goalError = '会话标题不是「<项目> · <成员>」格式，无法定位项目';
+          }
+        } catch (error) {
+          goalError = String(error && error.message);
+        }
+        // —— 真正替成员建 goal（2026-10-22）——
+        // 以前只发「请调用 create_goal」的文本指令，成员跳过就什么都没有；现在直接调
+        // DSH 的 goal 服务（ctx.goals = GoalService，签名 create(agent, {objective, maxGoalRounds})），
+        // 它会向**目标会话**的日志追加 `goal/change` 事件 —— 不依赖成员配合。
+        try {
+          const goalsSvc = hub.get('goals') || (typeof ctx.get === 'function' ? ctx.get('goals') : undefined);
+          const agentsSvc = hub.get('agents');
+          const targetAgent = (agentsSvc && typeof agentsSvc.get === 'function')
+            ? agentsSvc.get(String(session.id)) : undefined;
+          if (!goalsSvc || typeof goalsSvc.create !== 'function') {
+            goalCreateError = 'goal 服务（ctx.goals）不可用';
+          } else if (!targetAgent || !targetAgent.session) {
+            goalCreateError = '目标会话的 agent 不可用（可能未激活）';
+          } else {
+            try {
+              goalsSvc.create(targetAgent, { objective: goalText, maxGoalRounds: 12 });
+              goalCreated = true;
+            } catch (error) {
+              const msg = String((error && error.message) || error);
+              // 已有 goal：本质上"目标已存在"，不算失败
+              if (/GOAL_ALREADY_EXISTS|already exists/i.test(msg)) {
+                goalCreated = true;
+                goalCreateError = '已存在 goal（跳过重复创建）';
+              } else {
+                goalCreateError = msg;
+              }
+            }
+          }
+        } catch (error) {
+          goalCreateError = String((error && error.message) || error);
+        }
+        if (goalCreateError && !goalCreated) {
+          console.warn(`[hub-desktop-ui] taskline_prompt goal create failed: ${goalCreateError}`);
+        }
+        goalNote = goalDirective(goalText);
+      }
+      // —— 投递方式（2026-10-22）——
+      // 不传 mode = 老行为完全不变（controller.prompt mode:'queue' → agent.followup）。
+      // steer：controller.prompt mode:'steer' → agent.steer(message)（next-step 队列 + 唤醒），
+      //        只在目标 running 时有意义；空闲时退化为 queue。
+      // interrupt：controller.cancel({sessionId}) → agent.cancel({kind:'user'},{keepInbox:true})，
+      //        只中断当前轮、**不清 inbox**，已排队的下一条消息原样保留；
+      //        本条以 plugin-owned v4 消息排进 next-turn（不唤醒），等下次唤醒按序处理。
+      // 2026-11-08 用户令：默认投递方式从 queue 改成 triage —— 目标在跑就开分诊分身，不排队干等。
+      // 显式 mode:"queue" 仍可强制真排队；HUB_QUEUE_TRIAGE=0 全局回退旧行为。
+      // 2026-11-09 用户令（返回自相矛盾修复）：**一次快照 + 单一决策**——模式、note、
+      // 返回的 targetRunning、render 结论全部来自下面这一次 deps.snapshotTargetRunning。
+      const defaultMode = deps.queueTriageEnabled ? 'triage' : 'queue';
+      const requestedMode = String(args.mode || defaultMode).toLowerCase();
+      const agentsSvc = hub.get('agents');
+      const deliveryAgent = agentsSvc && typeof agentsSvc.get === 'function'
+        ? agentsSvc.get(String(session.id)) : undefined;
+      const runningSnapshot = await deps.snapshotTargetRunning(String(session.id));
+      const runningNow = runningSnapshot.running;
+      // interrupt 等 idle 的上限：调用方传 timeoutMs 就跟它走，否则用模块常量
+      //（长工具 abort 可能几秒；上限太短会误报 idle:false）
+      const requestedIdleWait = Number(args.timeoutMs);
+      const interruptIdleWaitMs = Number.isFinite(requestedIdleWait) && requestedIdleWait > 0
+        ? Math.min(Math.max(Math.floor(requestedIdleWait), 1000), 600000)
+        : INTERRUPT_IDLE_WAIT_MS;
+      const plan = planDelivery({
+        requestedMode,
+        running: runningNow,
+        triageEnabled: deps.queueTriageEnabled,
+        targetIsTriage: isQueueTriageTitle(deps.titleOfSession(session)),
+      });
+      let deliveredMode = plan.mode;
+      let modeNote = plan.note;
+      let interrupted = false;
+      let textQueued = false;
+      let idleAfterInterrupt;
+      const promptText = `${goalNote}${args.text}`;
+      if (deliveredMode === 'interrupt') {
+        if (!controller || typeof controller.cancel !== 'function') {
+          return { ok: false, error: 'sessionController.cancel 不可用，无法执行 interrupt' };
+        }
+        try {
+          await controller.cancel({ sessionId: String(session.id) });
+        } catch (error) {
+          return { ok: false, error: `中断失败：${String((error && error.message) || error)}` };
+        }
+        interrupted = true;
+        try {
+          if (deliveryAgent && deliveryAgent.inbox && typeof deliveryAgent.inbox.append === 'function') {
+            deliveryAgent.inbox.append('next-turn', noticeMessage(promptText, 'taskline-interrupt'));
+            textQueued = true;
+          } else {
+            modeNote = '拿不到目标 agent.inbox，本条未入队（已排队的消息仍保留）';
+          }
+        } catch (error) {
+          modeNote = `本条入队失败：${String((error && error.message) || error)}`;
+        }
+        idleAfterInterrupt = await deps.waitForAgentIdle(String(session.id), interruptIdleWaitMs);
+      }
+      // —— 分诊（2026-11-08 用户令）：目标在跑就不排队，立刻开分身判「steer 主线 / 分身自己做」——
+      let triageInfo = null;
+      if (deliveredMode === 'triage') {
+        const callerAgentForTriage = exec && exec.agent;
+        triageInfo = await deps.spawnQueueTriage({
+          targetId: String(session.id),
+          targetTitle: deps.titleOfSession(session),
+          callerTitle: callerAgentForTriage ? deps.callerTitleOf(callerAgentForTriage) : '',
+          callerSessionId: callerAgentForTriage && callerAgentForTriage.id !== undefined
+            ? String(callerAgentForTriage.id) : '',
+          // 传原始 text（不带 goal 指令前缀）：分诊分身看的是"这条消息本身"
+          text: String(args.text || ''),
+        });
+        if (!triageInfo.ok) {
+          // 分诊建不出来就退回普通排队——消息绝不能丢
+          deliveredMode = 'queue';
+          modeNote = `分诊分身建不出来（${triageInfo.error}），本条退回普通排队`;
+        }
+      }
+      try {
+        // 派活纪律（2026-10-26）：目标状态 + 排队位次直接进返回值；状态一律用上面
+        // 那**一次**快照，绝不在这里再查一次（2026-11-09：两处快照不一致正是本 bug）。
+        const targetRunning = runningNow;
+        const pendingBefore = deps.pendingDispatchesOf(session.id);
+        if (!interrupted && !(triageInfo && triageInfo.ok)) {
+          await controller.prompt({
+            requestId: `hub-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            sessionId: session.id,
+            mode: deliveredMode === 'steer' ? 'steer' : 'queue',
+            content: [{ type: 'text', text: promptText }],
+          }, new AbortController().signal);
+          deps.recordDispatch(session.id, targetRunning);
+        }
+        const pendingAfter = deps.pendingDispatchesOf(session.id);
+        const delivery = deliveryConclusion({
+          ok: true,
+          mode: deliveredMode,
+          targetRunning,
+          triageSessionId: triageInfo && triageInfo.ok ? triageInfo.sessionId : undefined,
+          interrupted,
+        });
+        return {
+          ok: true,
+          sessionId: session.id,
+          title: deps.titleOfSession(session),
+          // 派活纪律（2026-10-26）：目标状态 + 排队位次，直接进工具结果供管理者当场判断
+          targetRunning,
+          pendingDispatches: pendingAfter,
+          goal: goalText || '',
+          goalTaskId,
+          goalError,
+          // 三态：goalWritten = tasks.json 写入；goalCreated = 会话里真有 goal 事件；
+          // goalFailed = 建 goal 失败原因
+          goalWritten: Boolean(goalTaskId) && !goalError,
+          goalCreated,
+          goalFailed: goalText && !goalCreated ? (goalCreateError || 'unknown') : '',
+          goalMatchedBy,
+          ...(goalCandidates.length ? { candidates: goalCandidates } : {}),
+          mode: deliveredMode,
+          delivery,
+          ...(triageInfo && triageInfo.ok
+            ? { triageSessionId: triageInfo.sessionId, triageTitle: triageInfo.title }
+            : {}),
+          ...(interrupted ? { interrupted: true, textQueued } : {}),
+          ...(idleAfterInterrupt === undefined ? {} : { idle: idleAfterInterrupt }),
+          ...(modeNote ? { note: modeNote } : {}),
+          ...(pendingBefore > 0 ? { queuedBefore: pendingBefore } : {}),
+        };
+      } catch (error) {
+        return { ok: false, error: String(error && error.message) };
+      }
+    },
+  }));
+
+  // —— taskline_list ——
+  disposers.push(register({
+    name: 'taskline_list',
+    description: '列出所有可见会话（任务线）：sessionId、标题、是否运行中、是否分身。含重启后未激活的会话；sessionController 漏掉的冷会话从各项目 tasks.json 注册表补全（diag 里可见 rows/registry 两路计数）。',
+    parameters: { type: 'object', properties: {}, additionalProperties: false, required: [] },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['items'],
+        properties: {
+          items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              additionalProperties: false,
+              required: ['sessionId', 'title', 'running', 'subagent'],
+              properties: {
+                sessionId: { type: 'string' },
+                title: { type: 'string' },
+                running: { type: 'boolean' },
+                subagent: { type: 'boolean' },
+              },
+            },
+          },
+          diag: { type: 'string' },
+        },
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: (value.items.length === 0
+          ? '（没有活着的会话）'
+          : value.items.map((item) => `${item.sessionId}  ${item.title}${item.running ? ' [运行中]' : ''}${item.subagent ? ' [分身]' : ''}`).join('\n'))
+          + (value.diag ? `\n[diag] ${value.diag}` : ''),
+      }],
+    },
+    async execute() {
+      const sessions = hub.get('sessions');
+      // 底册用 sessionController.list()：读**全部可见会话**（含重启后未激活的冷会话），
+      // 不激活任何 Agent；行上的 running 官方已用 `agents.get(id)?.status === 'running'`
+      // 算好（Agent 的字段是 status 字符串，没有 running 布尔——之前读错位置恒为 false）。
+      const controller = hub.get('sessionController');
+      // 归档集合：registry-global 的 archivedSessionIds（api-session-controller 也这么读），
+      // 已归档/已回收的分身不该再出现在「活会话」列表里。
+      const registry = hub.get('workspaceRegistry');
+      const archivedSet = new Set(
+        registry && Array.isArray(registry.archivedSessionIds)
+          ? registry.archivedSessionIds.map(String)
+          : [],
+      );
+      let rows = null;
+      let rowsSource = 'none';
+      let listError = '';
+      if (controller && typeof controller.list === 'function') {
+        try {
+          const value = await controller.list(new AbortController().signal);
+          // list() 返回 {items:[...]}（Remote('list') 包装）或裸数组——两种都收
+          rows = value && Array.isArray(value.items) ? value.items : value;
+          if (Array.isArray(rows)) rowsSource = 'controller.list';
+        } catch (error) {
+          listError = String((error && error.message) || error);
+          console.warn(`[hub-desktop-ui] sessionController.list failed: ${listError}`);
+        }
+      }
+      if (!Array.isArray(rows)) {
+        // 兜底：controller 不可用时退回旧路径（只含活会话、无 running 判据）
+        const list = sessions && typeof sessions.list === 'function' ? sessions.list() : [];
+        rows = list.map((session) => ({
+          sessionId: session.id,
+          running: false,
+          origin: session.header && session.header.origin,
+          parentSessionId: session.header && session.header.parentSession,
+        }));
+        rowsSource = `fallback(${listError.slice(0, 60)})`;
+      }
+      const diagRunning = [];
+      const items = rows
+        .filter((row) => row && row.sessionId && !archivedSet.has(String(row.sessionId)))
+        .map((row) => {
+        const key = String(row.sessionId);
+        const live = sessions && typeof sessions.get === 'function' ? sessions.get(row.sessionId) : undefined;
+        // 标题：活会话走 sessionTitle；冷会话读官方缓存的 title 投影（用户改名=session/title 事件，已入缓存）
+        const projected = row.projections && row.projections.values ? row.projections.values.title : undefined;
+        const title = (live ? deps.titleOfSession(live) : '')
+          || (typeof projected === 'string' ? projected : '')
+          || `（未命名 ${String(row.sessionId).slice(0, 8)}…）`;
+        // 运行中：事件集合优先，其次 list 行现算字段（任一为真就算在跑）
+        const tracked = deps.liveRunning.has(key);
+        let agentStatus = 'n/a';
+        try {
+          const agents = hub.get('agents');
+          const agent = agents && typeof agents.get === 'function' ? agents.get(row.sessionId) : undefined;
+          agentStatus = agent ? String(agent.status) : 'no-agent';
+        } catch (error) { agentStatus = 'err'; }
+        // 运行中判据（实测校准）：`agents.get(id).status === 'running'` 是准的
+        //（诊断里自己的会话 st=running）；`sessionController.list()` 行里的 running
+        // 经 wire 传输后恒为 false，不可信；事件集合做兜底。
+        const running = agentStatus === 'running' || tracked || Boolean(row.running);
+        // 诊断：归档集合规模 + 被判为运行中的会话 id（排障用，正文不受影响）
+        if (running) diagRunning.push(key);
+        return {
+          sessionId: row.sessionId,
+          title,
+          running,
+          subagent: Boolean(row.origin === 'subagent' || row.parentSessionId
+            || (live && live.header && (live.header.origin === 'subagent' || live.header.parentSession))),
+        };
+      });
+      // —— 注册表补全（2026-10-22 修「taskline_list 只回 2-3 条」）——
+      // `sessionController.list()` 的返回行数实测会缩水（磁盘 175 会话/未归档约 27，
+      // 只回 3 行），管理者据此误判成员已归档、派错对象。各项目 tasks.json 的
+      // sessionIds 是协议要求维护的**注册表**：把里面未归档、且 list 没回的会话补进来
+      // （标题 = 项目 · 成员名），冷会话 running=false。归档集只用于排除，不裁剪活跃窗口。
+      const rowsRaw = rows.length;
+      const seen = new Set(items.map((item) => String(item.sessionId)));
+      let registryAdded = 0;
+      try {
+        const projectsDir = join(hostRoot(hub), '.hub', 'projects');
+        for (const dir of readdirSync(projectsDir)) {
+          let data = null;
+          try { data = JSON.parse(readFileSync(join(projectsDir, dir, 'tasks.json'), 'utf8')); } catch (error) { continue; }
+          if (!data || !Array.isArray(data.tasks)) continue;
+          for (const task of data.tasks) {
+            if (!task || task.status === 'archived') continue;
+            const members = Array.isArray(task.members) ? task.members : [];
+            const ids = Array.isArray(task.sessionIds) ? task.sessionIds.map(String) : [];
+            for (const id of ids) {
+              if (seen.has(id) || archivedSet.has(id)) continue;
+              seen.add(id);
+              registryAdded += 1;
+              const member = String(members[0] || task.title || '成员');
+              items.push({
+                sessionId: id,
+                title: `${dir} · ${member}`,
+                running: deps.liveRunning.has(id),
+                subagent: member.includes('｜'),
+              });
+            }
+          }
+        }
+      } catch (error) {
+        console.warn(`[hub-desktop-ui] registry merge failed: ${String(error)}`);
+      }
+      return {
+        items,
+        diag: `src=${rowsSource} rows=${rowsRaw} registry=+${registryAdded} archived=${archivedSet.size}`
+          + ` running=${diagRunning.length ? diagRunning.join(',') : 'none'}`,
+      };
+    },
+  }));
+
+  return disposers;
+}