dsh-agent-tasks 0.1.0 → 0.1.1

package/README.md

@@ -34,6 +34,20 @@ AI-Agent-Hub 的**任务线 + agent 通信**工具集，共 **12 个 MCP 工具*
 （共 12 处），管理者协议 `managerProtocol:232`。本包为占位，下一步搬入；
 搬入后**工具只能注册一次**，其余包通过 `ctx.get('agentTasks')` 调用。
 
+## 已知坑（读消息 / 派单模板）
+
+- **`taskline_messages` 恒返「没有消息」的根因（2026-11-10 修）**：两个叠加——①旧实现只读
+  活会话的 `session.events`；②持久日志把回复存成 `assistant/chunk` 的 block-end，正文**不在**
+  `data.message.content`。修法：走 `dsh-hub-core` 的 `readSessionEvents`（活 + 冷都能读）+
+  `compactSessionEvents` 重建正文。判据：`/sync/messages` 能读到而 `taskline_messages` 读不到 =
+  读法问题，不是会话空。
+- **`compactSessionEvents` 返回 `{ events, lastSeq, streaming }`，不是数组**（`Array.isArray()` 判空会漏）。
+- **它会把插件注入的 `user/message`（`source.kind !== 'user'`）过滤掉**，所以「原始 64 条 → 可展示 11 条」
+  是正常的，不是丢消息。
+- **eventId 恒为 `seq`**（真实事件没有 `id`/`key`），压缩后仍保留 `seq`，路由键不会漂移。
+- **§20 用户可见验收**：`taskline_create` / `taskline_prompt` 的 description 里已写死模板
+  （可打开产物 / 可复现命令输出 / 重启后一步核验），**禁自证式验收**。
+
 ## License
 
-MIT
+MIT

package/index.js

@@ -61,10 +61,17 @@ import {
   routingPath,
   handoffsDir,
   triageDecisionOf,
+  readSessionEvents,
+  compactSessionEvents,
 } from 'dsh-hub-core';
 
 export function registerAgentTools({ hub, register, deps = {} }) {
-  const { callerTitleOf, isRunningNow, pendingDispatchesOf, recordDispatch, resolveSession, snapshotTargetRunning, spawnQueueTriage, titleOfSession, waitForAgentIdle, wakeAgentMessageTarget, liveRunning, queueTriageEnabled } = 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）——
@@ -554,6 +561,10 @@ export function registerAgentTools({ hub, register, deps = {} }) {
         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: {
@@ -572,7 +583,17 @@ export function registerAgentTools({ hub, register, deps = {} }) {
       },
       render: (_args, value) => {
         if (!value.ok) return [{ type: 'text', text: `读取失败：${value.error}` }];
-        if (!value.items || value.items.length === 0) return [{ type: 'text', text: '（这个会话没有消息）' }];
+        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
@@ -582,8 +603,34 @@ export function registerAgentTools({ hub, register, deps = {} }) {
       },
     },
     async execute(args) {
-      const session = deps.resolveSession(args.session);
-      if (!session) return { ok: false, error: '找不到这个会话' };
+      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 只用于核对关键句。
@@ -591,21 +638,33 @@ export function registerAgentTools({ hub, register, deps = {} }) {
       const clip = (t) => String(t)
         .replace(/\s+/g, ' ')
         .slice(0, args.full === true ? fullCap : 400);
-      const controller = hub.get('sessionController');
-      const pools = [];
-      if (session && Array.isArray(session.events)) pools.push(session.events);
-      if (session && session.events && Array.isArray(session.events.entries)) pools.push(session.events.entries);
-      if (pools.length === 0 && controller && typeof controller.inspect === 'function') {
+      // 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 {
-          const info = await controller.inspect(session.id);
-          for (const candidate of [info.entries, info.events, info.prefix, info.record && info.record.events]) {
-            if (Array.isArray(candidate)) { pools.push(candidate); break; }
-          }
+          // 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] inspect failed: ${String(error)}`);
+          console.warn(`[hub-desktop-ui] compactSessionEvents failed: ${String(error)}`);
         }
       }
-      const events = pools[0] || [];
       const items = [];
       for (const event of events) {
         if (!event || (event.type !== 'user/message' && event.type !== 'assistant/message')) continue;
@@ -629,7 +688,29 @@ export function registerAgentTools({ hub, register, deps = {} }) {
           text,
         });
       }
-      return { ok: true, items: items.slice(-limit) };
+      // 三态判定（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' };
     },
   }));
 
@@ -1185,14 +1266,25 @@ export function registerAgentTools({ hub, register, deps = {} }) {
   // —— taskline_create ——
   disposers.push(register({
     name: 'taskline_create',
-    description: '新建一条任务线：创建一个新会话并命名（可选立刻给它派第一条任务）。',
+    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: '可选的初始任务内容' },
+        text: {
+          type: 'string',
+          description: '可选的初始任务内容。**必须含「【验收（用户可见）】」段**：'
+            + '列出用户可直接看/点/复制的验收物（产物路径或 URL、可复现命令与输出、重启后一步核验法），'
+            + '禁止只写「测试通过」「已自测」等自证。',
+        },
         preset: { type: 'string', description: '可选的 agent preset，默认 cordis（Creator mode）' },
         project: { type: 'string', description: '所属项目名，默认从 title 的「 · 」前解析' },
         avatar: { type: 'string', description: '头像 emoji，可不填（自动从候选池分配一个未被占用的）' },
@@ -1351,7 +1443,13 @@ export function registerAgentTools({ hub, register, deps = {} }) {
       required: ['session', 'text'],
       properties: {
         session: { type: 'string', description: '目标会话的 sessionId 或标题（可部分匹配）' },
-        text: { type: 'string', description: '要发给它的话，写清任务与验收标准' },
+        text: {
+          type: 'string',
+          description: '要发给它的话，写清任务与验收标准。'
+            + '**验收必须是「用户可见验收」**（§20）：给出用户能直接看/点/复制的验收物'
+            + '（产物路径或 URL、可复现命令及输出、重启后一步核验法），'
+            + '不要写「测试通过」「已自测」这类自证；模板见 taskline_create。',
+        },
         goal: {
           type: 'string',
           description: '本线目标（一句话、交付物导向）。传了会写进 tasks.json 的 goal 并把目标化指令插到 prompt 最前面；不传保持原行为',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-agent-tasks",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "Task-line and agent-messaging tools for AI-Agent-Hub DSH projects: taskline_create/prompt/list/messages/archive/rename/waits, agent_message, routing_put, resume_session, plus the project-manager protocol injection.",
   "main": "index.js",