dsh-tree-task-flow 0.3.11 → 0.3.12

package/lib/auto-continue.js

@@ -16,6 +16,7 @@
  */
 
 import { activePath, renderContinue } from "./plan.js";
+import { pluginSource } from "./region.js";
 
 /**
  * 注册续行兜底。
@@ -57,7 +58,8 @@ export function registerAutoContinue(ctx, { store, cfg }) {
   // 必须按来源区分，不能按"这一步有没有消息"：`agent.followup()` 推的消息同样会
   // 从 inbox 进入下一步的 `payload.messages`，那样每一轮都会把自己刚用掉的配额
   // 重置回去，`maxAutoRounds` 也就失去了意义。
-  // `source.kind === 'user'` 才是真人，插件推的是 `'plugin'`。
+  // `source.kind === 'user'` 才是真人，插件推的是 `plugin:dsh-tree-task-flow`
+  // （v3 老会话里是 `{ kind: 'plugin', plugin: 'dsh-tree-task-flow' }`；两种都不是 `'user'`）。
   //
   // 注意这是 waterfall：必须 await next() 并把它返回，否则会截断监听器链。
   ctx.on("agent/pre-step", async (payload, next) => {
@@ -106,7 +108,7 @@ export function registerAutoContinue(ctx, { store, cfg }) {
         id: `tt-continue-${sessionId}-${Date.now().toString(36)}`,
         role: "user",
         content: [{ type: "text", text: renderContinue(plan) }],
-        source: { kind: "plugin", plugin: "dsh-tree-task-flow", form: "notice", summary: "计划续行" },
+        source: pluginSource("计划续行"),
       });
       ctx.logger?.info?.(
         `dsh-tree-task-flow: 自动续行 ${used + 1}/${cfg.maxAutoRounds}（步骤 ${active.step.id}）`,

package/lib/compaction.js

@@ -10,8 +10,15 @@
  * 又明确要求"不要提及这次压缩"，模型不会自己想到去查。
  *
  * 怎么认：压缩留下的表层节点是一条 `user/message`，它的 `source` 由
- * `compactCheckpointSource()` 构造，标记固定为 `plugin: "compact"`
- * （见 `@deepseek-ai/dsh-compaction` 的 `isCompactCheckpointSource`）。
+ * `compactCheckpointSource()` 构造。**两个形状都要认**：
+ *
+ *   - v4 原生：`{ kind: "compact-checkpoint", compactionId, … }`
+ *     （`COMPACT_CHECKPOINT_MARKER` 就是 `{ kind: "compact-checkpoint" }`）；
+ *   - v3 老写法：`{ kind: "plugin", plugin: "compact" }`——它只在 v3 → v4 迁移里
+ *     被改写成前者，迁移前的会话里仍是这个样子。
+ *
+ * 只认老写法，会让**已经迁到 v4 的会话彻底收不到压缩提示**（实测：本机
+ * session-2083c383 在 v4 里连续压缩两次，一条提示都没有）。
  *
  * **不要认 `compaction/summary` 事件**：那是压缩自己的记录，不带 `surfaceOp`，
  * 因此根本不在表层里；真正替代被收走那段的是紧随其后那条带
@@ -35,14 +42,21 @@
 import { summaryMessage } from "./region.js";
 
 /**
- * 压缩检查点的插件标记。
+ * 压缩检查点的插件标记——**只有** v3 老写法用到它。
  *
- * 与 `@deepseek-ai/dsh-compaction` 的 `COMPACT_CHECKPOINT_MARKER` 保持一致的
- * 字面量。这里按形状判断而不是 import 那个包：插件不该为了认一个标记，
- * 就把一个 DSH 内部包写进自己的依赖里。
+ * 与 `@deepseek-ai/dsh-compaction` 的 V3 侧字面量保持一致。这里按形状判断而不是
+ * import 那个包：插件不该为了认一个标记，就把一个 DSH 内部包写进自己的依赖里。
  */
 const COMPACTION_PLUGIN = "compact";
 
+/**
+ * v4 原生压缩检查点的 source kind。
+ *
+ * 与 `@deepseek-ai/dsh-compaction` 的 `COMPACT_CHECKPOINT_MARKER` 一致
+ * （`{ kind: "compact-checkpoint" }`）。
+ */
+const COMPACTION_KIND = "compact-checkpoint";
+
 /**
  * 提示正文。
  *
@@ -64,11 +78,13 @@ function noticeId() {
   return `tt-compaction-${Date.now().toString(36)}-${noticeSeq.toString(36)}`;
 }
 
-/** 这条表层节点是不是压缩落下的检查点。 */
+/** 这条表层节点是不是压缩落下的检查点（v4 新写法与 v3 老写法都认）。 */
 function isCompactionCheckpoint(event) {
   if (event?.type !== "user/message") return false;
   const source = event.data?.source;
-  return source?.kind === "plugin" && source.plugin === COMPACTION_PLUGIN;
+  if (source === undefined || source === null) return false;
+  if (source.kind === COMPACTION_KIND) return true;
+  return source.kind === "plugin" && source.plugin === COMPACTION_PLUGIN;
 }
 
 /**

package/lib/pause.js

@@ -39,9 +39,7 @@
  */
 
 import { activePath, renderContinue } from "./plan.js";
-
-/** 本插件放下的消息都带这个身份。 */
-const PLUGIN = "dsh-tree-task-flow";
+import { pluginSource } from "./region.js";
 
 /**
  * 注册暂停闸门。
@@ -152,7 +150,7 @@ export function registerPause(ctx, { store = null, autoContinue = null } = {}) {
         id: `tt-resume-${sessionId}-${Date.now().toString(36)}`,
         role: "user",
         content: [{ type: "text", text: renderContinue(plan) }],
-        source: { kind: "plugin", plugin: PLUGIN, form: "notice", summary: "恢复续行" },
+        source: pluginSource("恢复续行"),
       });
     } catch (error) {
       return {

package/lib/region.js

@@ -42,7 +42,55 @@
 import { activePath } from "./plan.js";
 
 /** 本插件放下的消息都带这个身份。 */
-const PLUGIN = "dsh-tree-task-flow";
+export const PLUGIN = "dsh-tree-task-flow";
+
+/**
+ * 本插件消息的 source kind。
+ *
+ * DSH 的会话格式 v4 要求消息来源带**生产者自有的** kind：老写法
+ * `{ kind: "plugin", plugin: "包名" }` 只在 v3 → v4 迁移那一刻被改写成
+ * `plugin:<包名>`（第三方插件一律加前缀，见 `dsh-session-format-v3-to-v4`
+ * 的转换表）。**已经是 v4 的会话不再经过迁移**，写入时直接按 v4 校验，
+ * 于是老写法被拒：
+ *
+ *     format v4 message requires a producer-owned source kind
+ *
+ * 这条错误来自 DSH 自己的编码路径（`releasedV4SessionFormatCodec.encodeEvent`
+ * → `assertV4RowAdmission` → `assertV4SourceRowAdmission`），位置在会话落盘那一段，
+ * 插件自己的 try/catch 拦不住。所以从这里起**直接写迁移后的那个 kind**——
+ * 它在 v4 里合法，在 v3 里是"非空且非 plugin 的直接来源"，原样保留、同样合法。
+ */
+export const PLUGIN_SOURCE_KIND = `plugin:${PLUGIN}`;
+
+/**
+ * 本插件一条 notice 消息的 source。
+ *
+ * 字段与老写法保持一致：`form: "notice"` 让界面渲染成可展开的一行说明，
+ * `summary` 是那一行的文字。
+ *
+ * @param summary - 界面上显示的一行摘要。
+ * @returns 消息 source。
+ */
+export function pluginSource(summary) {
+  return { kind: PLUGIN_SOURCE_KIND, form: "notice", summary };
+}
+
+/**
+ * 这条 source 是不是本插件留下的。
+ *
+ * **两种写法都认**：v4 起写 `plugin:dsh-tree-task-flow`，而旧版留在 v3 会话里、
+ * 或压缩折叠区间里带着的老消息仍是 `{ kind: "plugin", plugin: "dsh-tree-task-flow" }`。
+ * 只认新写法会让老会话里的历史通告被当成普通过程，只认老写法会让新会话里的通告
+ * 被反复折叠。
+ *
+ * @param source - 消息的 source。
+ * @returns 是否本插件所留。
+ */
+export function isPluginSource(source) {
+  if (source === undefined || source === null) return false;
+  if (source.kind === PLUGIN_SOURCE_KIND) return true;
+  return source.kind === "plugin" && source.plugin === PLUGIN;
+}
 
 /** 三层固定的名字。只给界面用的游标同步按这个顺序走。 */
 const LEVELS = ["goal", "task", "step"];
@@ -100,7 +148,7 @@ function isHumanMessage(event) {
 
 /** 这条消息是不是本插件自己落下的折叠通告。 */
 function isPluginNotice(event) {
-  return event?.type === "user/message" && event.data?.source?.plugin === PLUGIN;
+  return event?.type === "user/message" && isPluginSource(event.data?.source);
 }
 
 /** 从一次工具调用的参数里取它指向的文件路径；不是文件类调用就返回 null。 */
@@ -149,18 +197,16 @@ export function touchedFiles(session, shadowed) {
  * 形态是 `notice` + `summary`：界面把它渲染成一行可读的说明，展开才是正文。
  * 刻意**不用** `snapshot`——那个形态是"运行时上下文快照"的专属标签，
  * 借用它会让任务汇总在界面上冒充系统提示词/运行环境快照。
+ *
+ * source 走 {@link pluginSource}：**必须是生产者自有的 kind**，否则 v4 会话
+ * 会拒绝这条消息（见 `PLUGIN_SOURCE_KIND` 的说明）。
  */
 export function summaryMessage(id, text, summary) {
   return {
     id,
     role: "user",
     content: [{ type: "text", text }],
-    source: {
-      kind: "plugin",
-      plugin: PLUGIN,
-      form: "notice",
-      summary,
-    },
+    source: pluginSource(summary),
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-tree-task-flow",
-  "version": "0.3.11",
+  "version": "0.3.12",
   "description": "树形任务流：把多步任务组织成目标→任务→子任务三级树，节点完成时由 AI 提交结果，插件随即把该节点的执行过程从上下文里折叠掉，只留下结果。",
   "type": "module",
   "main": "lib/index.js",