dsh-dispatch-board 0.2.8 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -164,6 +164,8 @@ dsh web
164
164
  - 组长忙 → 任务留在「待开始」等下一轮;组长离线 / 唤醒失败 → 跳过并提示「工作区组长不可用」
165
165
  (点组长条的「创建组长」可修复);
166
166
  - 只在组长会话**空闲**(idle)时投递;投递成功即自动置「进行中」;
167
+ - 投递到组长会话的看板通知在聊天页折叠成一条「收到执行请求」通知(v0.3.0),任务正文默认收起、
168
+ 不再像用户发言一样铺满对话窗口;轨迹页仍可查看完整原文;
167
169
  - 所有工作区共用一个轮询,每轮**全局最多投递 1 条**任务(多工作区轮流服务);
168
170
  - 同一个任务两次提醒之间至少等 `2 × 轮询间隔`(最长 120s),最多提醒 5 次,
169
171
  超过后不再自动提醒,任务留在「待开始」等你手动处理;
package/lib/client.js CHANGED
@@ -531,6 +531,9 @@ window.__ModuleLoader__.load({
531
531
  // v0.2.4:点「对话」失败不再静默(服务缺失 / 目标会话已关闭或不存在)。
532
532
  'openSession.failed': '无法打开对话:会话 {session} 已关闭或不存在',
533
533
  'openSession.unavailable': '无法打开对话:会话导航服务未就绪,请稍后重试',
534
+ // v0.2.9:回退 / 目标就是当前会话时必须说出来(否则看起来就是「点了没反应」)。
535
+ 'openSession.fallback': '执行对话不可用(worker 会话已中断或丢失),已打开组长对话 · {session}',
536
+ 'openSession.stale': '这条任务的执行对话已失效,没有可跳转的会话',
534
537
  'detail.sessions': '关联对话',
535
538
  'detail.creatorSession': '发起对话',
536
539
  'detail.runSession': '执行对话',
@@ -717,6 +720,9 @@ window.__ModuleLoader__.load({
717
720
  // Unreleased (0.2.4 candidate): a failed 对话 click must never be silent.
718
721
  'openSession.failed': 'Cannot open conversation: session {session} is closed or unavailable',
719
722
  'openSession.unavailable': 'Cannot open conversation: session navigation is not ready yet, please retry',
723
+ // v0.2.9: a fallback (or a target equal to the current conversation) must be visible too.
724
+ 'openSession.fallback': 'Worker conversation is gone (interrupted or removed); opened the lead conversation · {session}',
725
+ 'openSession.stale': 'This task has no reachable conversation; nothing to open',
720
726
  'detail.sessions': 'Linked conversations',
721
727
  'detail.creatorSession': 'Created in',
722
728
  'detail.runSession': 'Dispatched to',
@@ -1042,11 +1048,18 @@ window.__ModuleLoader__.load({
1042
1048
  return sessionId.length > 8 ? sessionId.slice(-8) : sessionId
1043
1049
  }
1044
1050
 
1045
- // 会话 id 只认两种形态:`session-<id>`(宿主会话)与裸 UUID(宿主 `subagentId` 就是会话 UUID)。
1046
- // 任务 `assignee` 是自由文本,组长也可能写 `worker-42` / `main` 这类普通标签,那些不是会话。
1047
- const SESSION_ID_PATTERN = /^(?:session-[A-Za-z0-9_-]+|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i
1051
+ // 会话 id 只认三种形态(v0.2.9 收紧):`session-<纯数字>`(历史时间戳 id)、`session-<uuid>`
1052
+ // (当前宿主)、裸 UUID(宿主 `subagentId` 就是会话 UUID);另外兼容 `session-<hex 8+>`(历史 hex id)。
1053
+ // **`session-` 后不能是任意字母串**:组长会把 subagent 名字写进 `assignee`(实测 `session-jump-bug` /
1054
+ // `session-worker1111`),旧规则把它们当会话 id,看板「对话」点开必失败后静默回退到当前会话——
1055
+ // 用户看到的就是「点了没反应」。真正在跑的 worker 会话 id 由宿主记在 `workerSessionId`(§2)。
1056
+ const SESSION_ID_PATTERN =
1057
+ /^(?:session-(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[0-9a-f][0-9a-f-]{7,}|\d+)|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i
1048
1058
  // 从自由文本里找会话 id token 用:不带锚点,但两侧边界不能是 `[A-Za-z0-9_-]`(见 extractSessionId)。
1049
- const SESSION_TOKEN_PATTERN = /session-[A-Za-z0-9_-]+|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi
1059
+ // 形态与 SESSION_ID_PATTERN 完全一致(同一口径,别只收紧一半);alternative 顺序必须是
1060
+ // **长的在前**——不带锚点时 `\d+` 会先把 `session-6a5f0f02-…` 截成 `session-6`,边界判定随后把它丢掉。
1061
+ const SESSION_TOKEN_PATTERN =
1062
+ /session-(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[0-9a-f][0-9a-f-]{7,}|\d+)|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi
1050
1063
  const SESSION_TOKEN_EDGE = /[A-Za-z0-9_-]/
1051
1064
 
1052
1065
  /** 整串就是会话 id(严格判定,不做提取)。 */
@@ -1087,6 +1100,22 @@ window.__ModuleLoader__.load({
1087
1100
  return extractSessionId(task.assignee)
1088
1101
  }
1089
1102
 
1103
+ /**
1104
+ * 宿主独占的执行会话 id(v0.2.9,§2):`task.workerSessionId`。
1105
+ * 这个字段只由宿主写(`tools/result` 拿到 `subagentId` 时**总是**覆盖),模型改不了,
1106
+ * 所以它比 `assignee` 可信——后者是组长随手写的 label / 名字,可能根本不是会话 id。
1107
+ */
1108
+ function workerSessionIdOf(task) {
1109
+ if (!task || typeof task !== 'object') return ''
1110
+ return extractSessionId(task.workerSessionId)
1111
+ }
1112
+
1113
+ /** 执行会话:宿主字段 `workerSessionId` 优先,老 Host(没有该字段)回退 `assignee` 文本。 */
1114
+ function taskWorkerSession(task) {
1115
+ const hostWritten = workerSessionIdOf(task)
1116
+ return hostWritten !== '' ? hostWritten : workerSessionOf(task)
1117
+ }
1118
+
1090
1119
  /* ── v0.2.0 组长条(主会话 / 工作区组长)纯展示函数 ───────── */
1091
1120
 
1092
1121
  // 「派发到」的四个合法值:v0.2.0 起默认 workspace-lead(缺省 / 未知一律回退它,不要回退 new)。
@@ -2046,8 +2075,38 @@ window.__ModuleLoader__.load({
2046
2075
  return last
2047
2076
  }
2048
2077
 
2078
+ /**
2079
+ * 卡片「对话」一次点击的判定(v0.2.9,两块看板共用;行为在 test/client-render.test.mjs
2080
+ * 里通过两块看板的真实渲染验证):
2081
+ * - 候选链里只剩**当前会话**:`uiWorkspace.openSession` 是同步 void,打开当前会话 = 界面毫无变化
2082
+ * (旧行为看起来就是「点了没反应」)→ 不调用它,直接按 `reason:'stale'` 出提示;
2083
+ * - 首选能打开 → `{result, fallback:false}`;
2084
+ * - 首选打不开、回退到别的会话 → `{result, fallback:true}`,调用方**必须**把回退说出来;
2085
+ * - 全都打不开(会话已关闭 / 不存在)→ 原样返回失败结果(走 `openSession.failed` 文案)。
2086
+ */
2087
+ function chatOpenOutcome(candidates, currentSessionId) {
2088
+ const list = (Array.isArray(candidates) ? candidates : []).filter(
2089
+ (id) => typeof id === 'string' && id !== '',
2090
+ )
2091
+ const primary = list.length > 0 ? list[0] : ''
2092
+ const current = typeof currentSessionId === 'string' ? currentSessionId : ''
2093
+ // 当前会话本身作为跳转目标是空操作:先摘掉它再试,剩下的都打不开才说「执行对话已失效」。
2094
+ const openable = current === '' ? list : list.filter((id) => id !== current)
2095
+ if (openable.length === 0) {
2096
+ return { result: { ok: false, reason: 'stale', sessionId: primary }, fallback: false }
2097
+ }
2098
+ const result = openFirstAvailable(openable)
2099
+ return { result, fallback: result.ok === true && primary !== '' && result.sessionId !== primary }
2100
+ }
2101
+
2049
2102
  /** 跳转失败的顶部提示文案(两块看板共用;`t` 由组件传入,保持纯函数可测)。 */
2050
- function sessionFailureText(t, result, candidates) {
2103
+ function sessionFailureText(t, result, candidates, options) {
2104
+ // v0.2.9:回退到别的会话(首选 worker 打不开 / 目标就是当前会话)也必须说出来——
2105
+ // 「打开成功但界面没变」是最容易让人以为按钮坏了的情况。
2106
+ if (options && options.fallback === true && result && result.ok === true) {
2107
+ return t('openSession.fallback', { session: shortSession(result.sessionId) })
2108
+ }
2109
+ if (result && result.reason === 'stale') return t('openSession.stale')
2051
2110
  if (result && result.reason === 'unavailable') return t('openSession.unavailable')
2052
2111
  const list = Array.isArray(candidates) ? candidates : []
2053
2112
  const first = list.find((id) => typeof id === 'string' && id !== '') || ''
@@ -2272,9 +2331,10 @@ window.__ModuleLoader__.load({
2272
2331
  }
2273
2332
 
2274
2333
  /**
2275
- * 任务关联的会话(卡片「对话」按钮的跳转目标),优先级:
2276
- * worker 子会话(真正执行任务的对话)→ 组长会话(dispatchedSessionId)→ 发起对话(sessionId)
2277
- * → 老 Host 的 poll 兜底(doing)。
2334
+ * 任务关联的会话(卡片「对话」按钮的跳转目标),优先级(v0.2.9):
2335
+ * **宿主记的执行会话** `workerSessionId` → worker 子会话(旧 Host:从 `assignee` 提取,
2336
+ * 用收紧后的正则,subagent 名字不再算会话)→ 组长会话(dispatchedSessionId)
2337
+ * → 发起对话(sessionId)→ 老 Host 的 poll 兜底(doing)。
2278
2338
  *
2279
2339
  * 返回**去重后的候选链**(v0.2.4):worker 子会话是子 Agent 会话,客户端未必解析得到
2280
2340
  * (侧栏隐藏、依赖父会话 catalog),打不开时不能连累整次点击——调用方按顺序试到第一个能打开的。
@@ -2285,6 +2345,7 @@ window.__ModuleLoader__.load({
2285
2345
  const push = (value) => {
2286
2346
  if (typeof value === 'string' && value !== '' && out.indexOf(value) < 0) out.push(value)
2287
2347
  }
2348
+ push(workerSessionIdOf(task))
2288
2349
  push(workerSessionOf(task))
2289
2350
  push(task.dispatchedSessionId)
2290
2351
  push(task.sessionId)
@@ -2595,8 +2656,9 @@ window.__ModuleLoader__.load({
2595
2656
  // 标题/按钮之间只留 gap,不再用整卡 min-height + 操作行 margin-top:auto 撑空行)。
2596
2657
 
2597
2658
  cardActions.unshift(['detail', () => actions.openDetail(task), false])
2598
- // 卡片「对话」优先 worker 子会话(真正干活的对话),其次组长 / 发起对话;title 用实际目标 id 便于辨认。
2599
- // 点击走 actions.openChat(task):worker 打不开时自动回退组长 / 发起会话,全部失败出顶部提示(不静默)。
2659
+ // 卡片「对话」的目标:宿主记的执行会话 workerSessionId 优先(v0.2.9),老 Host 回退 worker /
2660
+ // 组长 / 发起对话;title 用实际目标 id 便于辨认。assignee 里的 subagent 名字不再当会话 id。
2661
+ // 点击走 actions.openChat(task):worker 打不开时自动回退组长 / 发起会话,全部失败 / 回退都出提示(不静默)。
2600
2662
  const cardSessionId = sessionOf(task)
2601
2663
  if (cardSessionId !== '') {
2602
2664
  const openChatAction = () => (typeof actions.openChat === 'function' ? actions.openChat(task) : actions.openSession(cardSessionId))
@@ -2683,10 +2745,11 @@ window.__ModuleLoader__.load({
2683
2745
  [t('detail.archived'), fmtShortWhen(task.archivedAt), fmtWhen(task.archivedAt)],
2684
2746
  ]
2685
2747
  const resultEmpty = task.status === 'done' && !task.result
2686
- // 「关联对话」:发起(sessionId)/ 执行(worker assignee)/ 组长(dispatchedSessionId / poll 兜底),
2687
- // 各自可点;同一个会话只显示一次(worker 可能等于发起会话,组长会话也可能等于发起会话)。
2748
+ // 「关联对话」:发起(sessionId)/ 执行(宿主 workerSessionId,老 Host 回退 assignee)/
2749
+ // 组长(dispatchedSessionId / poll 兜底),各自可点;同一个会话只显示一次
2750
+ // (worker 可能等于发起会话,组长会话也可能等于发起会话)。
2688
2751
  const creatorSession = typeof task.sessionId === 'string' ? task.sessionId : ''
2689
- const workerSession = workerSessionOf(task)
2752
+ const workerSession = taskWorkerSession(task)
2690
2753
  const leadSession = leadSessionOf(task)
2691
2754
  const detailSessions = []
2692
2755
  if (creatorSession !== '') {
@@ -3402,14 +3465,15 @@ window.__ModuleLoader__.load({
3402
3465
  * t-71:浮层开着时把提示交给浮层(`detailNotice`)渲染——`.tb-detail-mask` 是 z-index:9000
3403
3466
  * 的全屏遮罩,看板顶部横幅在它下面,用户看不见。成功跳转顺带清掉上一次的会话失败提示;
3404
3467
  * `kind:'session'` 标记保证只清自己设的提示,不误清「派发成功」「已归档」等其它通知。
3468
+ * v0.2.9:回退到别的会话(`options.fallback`)算成功但不静默——照样出 warn。
3405
3469
  */
3406
- function reportSessionFailure(result, candidates) {
3407
- if (result && result.ok) {
3470
+ function reportSessionFailure(result, candidates, options) {
3471
+ if (result && result.ok && !(options && options.fallback === true)) {
3408
3472
  setNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
3409
3473
  setDetailNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
3410
3474
  return result
3411
3475
  }
3412
- const item = { tone: 'warn', text: sessionFailureText(t, result, candidates), kind: 'session' }
3476
+ const item = { tone: 'warn', text: sessionFailureText(t, result, candidates, options), kind: 'session' }
3413
3477
  if (detailId !== null) {
3414
3478
  setDetailNotice(item)
3415
3479
  setNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
@@ -3424,11 +3488,16 @@ window.__ModuleLoader__.load({
3424
3488
  return reportSessionFailure(openSessionById(sessionId), [sessionId])
3425
3489
  }
3426
3490
 
3427
- /** 任务卡片的「对话」:按候选链(worker → 组长 → 发起 → poll 兜底)试到第一个能打开的。 */
3491
+ /**
3492
+ * 任务卡片的「对话」:按候选链(workerSessionId → worker → 组长 → 发起 → poll 兜底)
3493
+ * 试到第一个能打开的;回退 / 只剩当前会话时都给可见提示(v0.2.9)。
3494
+ * 当前会话用本看板绑定的 `sessionId`(右栏 tab 的会话 scope)。
3495
+ */
3428
3496
  function openChatAction(task) {
3429
3497
  const pieces = boardPiecesRef.current
3430
3498
  const candidates = pieces && typeof pieces.sessionCandidatesOf === 'function' ? pieces.sessionCandidatesOf(task) : []
3431
- return reportSessionFailure(openFirstAvailable(candidates), candidates)
3499
+ const outcome = chatOpenOutcome(candidates, sessionId)
3500
+ return reportSessionFailure(outcome.result, candidates, { fallback: outcome.fallback })
3432
3501
  }
3433
3502
 
3434
3503
  /* ── 组长条动作(v0.2.0)────────────────────────────────── */
@@ -4251,14 +4320,15 @@ window.__ModuleLoader__.load({
4251
4320
  * 与右栏看板同一套反馈:能打开就跳转,打不开就出 warn 横幅。
4252
4321
  * t-71:浮层开着时提示渲染在浮层内部(`detailNotice`),否则看板顶部横幅会被遮罩盖住;
4253
4322
  * 成功跳转只清 `kind:'session'` 的旧提示(不误清派发 / 归档等其它通知)。
4323
+ * v0.2.9:回退到别的会话(`options.fallback`)算成功但不静默——照样出 warn。
4254
4324
  */
4255
- function reportSessionFailure(result, candidates) {
4256
- if (result && result.ok) {
4325
+ function reportSessionFailure(result, candidates, options) {
4326
+ if (result && result.ok && !(options && options.fallback === true)) {
4257
4327
  setNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
4258
4328
  setDetailNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
4259
4329
  return result
4260
4330
  }
4261
- const item = { tone: 'warn', text: sessionFailureText(t, result, candidates), kind: 'session' }
4331
+ const item = { tone: 'warn', text: sessionFailureText(t, result, candidates, options), kind: 'session' }
4262
4332
  if (detailId !== null) {
4263
4333
  setDetailNotice(item)
4264
4334
  setNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
@@ -4273,11 +4343,16 @@ window.__ModuleLoader__.load({
4273
4343
  return reportSessionFailure(openSessionById(sessionId), [sessionId])
4274
4344
  }
4275
4345
 
4276
- /** 任务卡片的「对话」:按候选链(worker → 组长 → 发起 → poll 兜底)试到第一个能打开的。 */
4346
+ /**
4347
+ * 任务卡片的「对话」:按候选链(workerSessionId → worker → 组长 → 发起 → poll 兜底)
4348
+ * 试到第一个能打开的;回退 / 只剩当前会话时都给可见提示(v0.2.9)。
4349
+ * 平台看板没有 session scope:当前会话取 `lastConversationSessionId`(宿主渲染过的最近对话)。
4350
+ */
4277
4351
  function openChatAction(task) {
4278
4352
  const pieces = boardPiecesRef.current
4279
4353
  const candidates = pieces && typeof pieces.sessionCandidatesOf === 'function' ? pieces.sessionCandidatesOf(task) : []
4280
- return reportSessionFailure(openFirstAvailable(candidates), candidates)
4354
+ const outcome = chatOpenOutcome(candidates, lastConversationSessionId)
4355
+ return reportSessionFailure(outcome.result, candidates, { fallback: outcome.fallback })
4281
4356
  }
4282
4357
 
4283
4358
  /* ── 组长条动作(v0.2.0,与右栏看板同一套 RPC)──────────── */
@@ -4753,6 +4828,9 @@ window.__ModuleLoader__.load({
4753
4828
  // v0.2.0 任务关联对话:worker 会话判定(assignee 只在能提取到会话 id 时算会话)
4754
4829
  workerSessionOf,
4755
4830
  extractSessionId,
4831
+ // v0.2.9:宿主独占的 workerSessionId(优先)+ 卡片「对话」的执行会话判定
4832
+ workerSessionIdOf,
4833
+ taskWorkerSession,
4756
4834
  groupTasks,
4757
4835
  statusAccent: STATUS_ACCENT,
4758
4836
  statusOrder: STATUS_ORDER,
package/lib/index.js CHANGED
@@ -113,6 +113,29 @@ const ATTACHMENT_REF_PATTERN = /!\[[^\]]*\]\(attachment:\/\/([0-9a-f]{8}-[0-9a-f
113
113
  * 轮询投递任务 / 人工任务恒为 null —— 组长把它们的 assignee 写成 worker 会话 id 也不会被宿主抢答。
114
114
  */
115
115
  export const LEAD_AUTO_MARK = 'lead-dispatch'
116
+ /**
117
+ * v0.2.9:worker 执行状态(宿主独占字段 `task.workerRunState`,模型不可写,§2)。
118
+ * - `'running'`:`tools/result` 确认 worker 已启动;
119
+ * - `'failed'`:`subagent/end` 收到非 `completed` 的结束(会话可能已被移除);
120
+ * - `'ended'`:`subagent/end` 收到 `completed`(执行会话 id 保留,仍可回看对话);
121
+ * - `null`:还没派过 worker(含老 board.json 缺字段)。
122
+ */
123
+ export const WORKER_RUN_STATES = Object.freeze(['running', 'failed', 'ended'])
124
+ /**
125
+ * v0.2.9:会话 id 形态(Host / Client 同一条口径,`looksLikeSessionId` 用它)。
126
+ *
127
+ * 只认三种真会话 id:
128
+ * - `session-<纯数字>`:历史时间戳式会话 id(如 `session-1747351234567`);
129
+ * - `session-<uuid>`:当前宿主形态(如 `session-042eeecd-19bc-400d-9e1b-5db67d5ee2b3`);
130
+ * - 裸 UUID:`subagentId` 就是会话 UUID。
131
+ * 另外兼容 `session-<hex 8 位以上>`(历史 hex id / 测试数据,如 `session-aaaa1111`)。
132
+ *
133
+ * 关键收紧:`session-` 后**不能是任意字母串**。组长会把 subagent 的名字写进 `assignee`
134
+ * (实测 `session-jump-bug` / `session-jump-fix`),旧规则 `session-[0-9a-z-]{8,}` 把名字当会话 id,
135
+ * 认领判定(`canReuseMentionedTask`)与看板「对话」跳转都跟着错。
136
+ */
137
+ const SESSION_ID_PATTERN =
138
+ /^(?:session-(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[0-9a-f][0-9a-f-]{7,}|\d+)|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i
116
139
  /**
117
140
  * §1.8 in-flight 去重的陈旧窗口:组长名下「doing + notifiedAt」的轮询任务超过这个时长没有更新
118
141
  * (worker 长跑 / 组长卡死)就不再挡住直聊派活——宁可多一条可见任务,也不让派活无声消失。
@@ -447,6 +470,10 @@ function normalizeTask(raw, index) {
447
470
  answeredAt: asString(raw.answeredAt) || null,
448
471
  cwd: typeof raw.cwd === 'string' && raw.cwd !== '' ? raw.cwd : null,
449
472
  assignee: trimmed(raw.assignee, 200),
473
+ // v0.2.9(§2):宿主独占的「执行会话 id / 执行状态」。模型不可写(不在 taskboard_update 白名单、
474
+ // applyTaskUpdate 也不读这两个键),老 board.json 缺字段一律 null;不做迁移。
475
+ workerSessionId: trimmed(raw.workerSessionId, 200) || null,
476
+ workerRunState: WORKER_RUN_STATES.includes(raw.workerRunState) ? raw.workerRunState : null,
450
477
  result: truncateNote(raw.result, MAX_NOTE_CHARS),
451
478
  createdAt: asString(raw.createdAt) || iso(Date.now()),
452
479
  updatedAt: asString(raw.updatedAt) || asString(raw.createdAt) || iso(Date.now()),
@@ -867,6 +894,9 @@ export function addTask(state, input, now = Date.now()) {
867
894
  answeredAt: null,
868
895
  cwd: typeof input.cwd === 'string' && input.cwd !== '' ? input.cwd : null,
869
896
  assignee: '',
897
+ // v0.2.9(§2):宿主独占字段,建任务时都还没有 worker。
898
+ workerSessionId: null,
899
+ workerRunState: null,
870
900
  result: '',
871
901
  createdAt: stamp,
872
902
  updatedAt: stamp,
@@ -1004,6 +1034,10 @@ export function applyTaskUpdate(state, id, patch, now = Date.now()) {
1004
1034
  task.notifiedAt = null
1005
1035
  task.notificationCount = 0
1006
1036
  task.assignee = ''
1037
+ // v0.2.9:回到待开始 = 下一轮会派新的 worker,执行会话记账一起清空
1038
+ // (旧 worker 的会话已中断 / 已失效,留着只会让看板「对话」指向一个打不开的会话)。
1039
+ task.workerSessionId = null
1040
+ task.workerRunState = null
1007
1041
  task.reportedAt = null
1008
1042
  // 重新排队后由轮询投递、归组长审核:不再是「宿主自动任务」,别再被 subagent/end 自动 done(§1.8)。
1009
1043
  task.autoDispatch = null
@@ -1262,6 +1296,9 @@ export function requeueTasksOfLead(state, sessionId, now = Date.now()) {
1262
1296
  task.notifiedAt = null
1263
1297
  task.notificationCount = 0
1264
1298
  task.assignee = ''
1299
+ // v0.2.9:重排后旧 worker 的执行会话记账一并清空(与 applyTaskUpdate 的 →todo 同口径)。
1300
+ task.workerSessionId = null
1301
+ task.workerRunState = null
1265
1302
  task.dispatchedSessionId = null
1266
1303
  task.dispatchedSessionTitle = ''
1267
1304
  // §1.9:重排后这条任务不再由旧组长/旧提问者跟进,清掉问题标记——
@@ -1410,15 +1447,30 @@ export function buildDispatchText(task, now = Date.now()) {
1410
1447
  }
1411
1448
 
1412
1449
  /**
1413
- * 手工构造一条 UserMessage(等价于 @deepseek-ai/dsh-llm 的 createUserMessage,
1414
- * 但本包不 import 它)。source 用内置的 {kind:'user'},保证会话日志解码器一定认识。
1450
+ * 看板注入消息的 source.kind(v0.3.0)。
1451
+ *
1452
+ * 为什么不用内建 {kind:'user'}:
1453
+ * - DSH 客户端把 source.kind !== 'user' 的 user 角色消息当作「注入/触发」,
1454
+ * 不再渲染成用户发言气泡,而是折叠成一条「收到执行请求」通知(点开才看正文);
1455
+ * 派单/回执几千字的正文因此不会再铺满对话窗口。
1456
+ * - 插件、调度器等非人类生产方使用自己的 source.kind 也是 DSH 的官方语义
1457
+ * (省略 source 或写 'user' 会被当成真人直接消息,goal 等工具据此放行人类权限)。
1458
+ *
1459
+ * 兼容性:会话格式 v4 只要求 source.kind 是非空字符串(仅拒绝字面量 'plugin'),
1460
+ * 未知 producer kind 原样保留,重启后会话可正常解码。
1461
+ */
1462
+ export const BOARD_MESSAGE_SOURCE_KIND = 'dispatch-board'
1463
+
1464
+ /**
1465
+ * 手工构造一条 user 角色消息(等价于 @deepseek-ai/dsh-llm 的 createUserMessage,
1466
+ * 但本包不 import 它)。source 用本插件自己的 kind,见 {@link BOARD_MESSAGE_SOURCE_KIND}。
1415
1467
  */
1416
1468
  export function createBoardUserMessage(text) {
1417
1469
  return {
1418
1470
  id: randomUUID(),
1419
1471
  role: 'user',
1420
1472
  content: [{ type: 'text', text }],
1421
- source: { kind: 'user' },
1473
+ source: { kind: BOARD_MESSAGE_SOURCE_KIND },
1422
1474
  }
1423
1475
  }
1424
1476
 
@@ -3016,12 +3068,18 @@ export function dispatchReferencedTaskId(text) {
3016
3068
  return ''
3017
3069
  }
3018
3070
 
3019
- /** assignee 看起来是不是一个真实 worker 会话 id(UUID / session-…);自由文本标签(如 taskboard-worker)不算。 */
3071
+ /**
3072
+ * assignee 看起来是不是一个真实 worker 会话 id(UUID / `session-<数字或 UUID>` / `session-<hex>`);
3073
+ * 自由文本标签(`taskboard-worker`)与 subagent 名字(`session-jump-bug`)都不算。
3074
+ *
3075
+ * v0.2.9 收紧:旧规则 `/^session-[0-9a-z-]{8,}$/i` 把 `session-jump-bug` 当会话 id,于是
3076
+ * 「看板任务:t-N」认领会被名字骗过(`canReuseMentionedTask`),看板「对话」也指向假会话。
3077
+ * 现在与 Client 共用同一条形态(`SESSION_ID_PATTERN`),见 §2 的 `workerSessionId`。
3078
+ */
3020
3079
  export function looksLikeSessionId(value) {
3021
3080
  const text = typeof value === 'string' ? value.trim() : ''
3022
3081
  if (text === '') return false
3023
- if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(text)) return true
3024
- return /^session-[0-9a-z-]{8,}$/i.test(text)
3082
+ return SESSION_ID_PATTERN.test(text)
3025
3083
  }
3026
3084
 
3027
3085
  /**
@@ -3224,6 +3282,9 @@ export function prepareLeadDispatch(rt, input, now = Date.now()) {
3224
3282
  task.autoDispatch = LEAD_AUTO_MARK
3225
3283
  task.dispatchedSessionId = leadId || null
3226
3284
  task.dispatchedSessionTitle = sessionTitle(agent)
3285
+ // v0.2.9(§2):建卡时 worker 还没启动,执行会话未知;`tools/result` 拿到 subagentId 才写。
3286
+ task.workerSessionId = null
3287
+ task.workerRunState = null
3227
3288
  task.lastError = ''
3228
3289
  task.updatedAt = iso(now)
3229
3290
  const saved = commitBoard(rt.state, rt.filePath)
@@ -3403,6 +3464,11 @@ export function handleSubagentDispatch(rt, input, now = Date.now()) {
3403
3464
  }
3404
3465
  // 自动建的卡片归当前 worker;轮询任务只在还没挂 worker 时补——组长审核的对象不被覆盖。
3405
3466
  if (task.autoDispatch === LEAD_AUTO_MARK || task.assignee === '') task.assignee = childId
3467
+ // v0.2.9(§2):执行会话 id 由宿主独占,**总是**覆盖为本次 `subagentId`——不看 `autoDispatch`、
3468
+ // 不看已有 `assignee`。组长把 assignee 写成 subagent 名字(实测 `session-jump-bug`)时,
3469
+ // 看板「对话」仍指向真正在跑的那个会话;重派后也不会继续指向旧 worker。
3470
+ task.workerSessionId = childId
3471
+ task.workerRunState = 'running'
3406
3472
  if (sessionId !== '' && asString(task.dispatchedSessionId) === '') task.dispatchedSessionId = sessionId
3407
3473
  if (asString(task.dispatchedSessionTitle) === '') task.dispatchedSessionTitle = sessionTitle(agent)
3408
3474
  task.lastError = ''
@@ -3445,6 +3511,9 @@ export function handleSubagentDispatch(rt, input, now = Date.now()) {
3445
3511
  applyTaskUpdate(rt.state, task.id, { status: 'doing', assignee: childId }, now)
3446
3512
  // 持久化标记:只有带这个标记的任务才允许 subagent/end 自动收尾(§1.8 / §2)。
3447
3513
  task.autoDispatch = LEAD_AUTO_MARK
3514
+ // v0.2.9(§2):兜底建卡路径也由宿主记执行会话 id / 执行状态(与 prepared 分支同口径)。
3515
+ task.workerSessionId = childId
3516
+ task.workerRunState = 'running'
3448
3517
  task.dispatchedSessionId = sessionId || null
3449
3518
  task.dispatchedSessionTitle = sessionTitle(agent)
3450
3519
  task.lastError = ''
@@ -3512,6 +3581,10 @@ export async function handleSubagentEnd(rt, info, now = Date.now()) {
3512
3581
  }
3513
3582
  const detail = result === '' ? '没有返回结论' : flattenResultLine(result, RECEIPT_RESULT_CHARS)
3514
3583
  task.lastError = trimmed('worker 结束(' + stopReason + '):' + detail, 500)
3584
+ // v0.2.9(§2):worker 异常中断(非 completed)时**保留**执行会话 id 与 assignee,只把运行状态
3585
+ // 标成 failed——看板「对话」仍会先试那个 worker 会话,打不开时客户端给可见回退提示。
3586
+ if (asString(task.workerSessionId) === '') task.workerSessionId = childId
3587
+ task.workerRunState = 'failed'
3515
3588
  task.updatedAt = iso(now)
3516
3589
  commitBoard(rt.state, rt.filePath)
3517
3590
  // 只写任务 lastError;leadAuto.lastError 语义是「挂钩自身失败原因」,不装派发结果。
@@ -3536,6 +3609,9 @@ export async function handleSubagentEnd(rt, info, now = Date.now()) {
3536
3609
  }
3537
3610
  applyTaskUpdate(rt.state, task.id, patch, now)
3538
3611
  task.lastError = ''
3612
+ // v0.2.9(§2):正常结束 → **保留**执行会话 id(还能回看 worker 对话),只把运行状态标成 ended。
3613
+ if (asString(task.workerSessionId) === '') task.workerSessionId = childId
3614
+ task.workerRunState = 'ended'
3539
3615
  task.updatedAt = iso(now)
3540
3616
  commitBoard(rt.state, rt.filePath)
3541
3617
  // 只在真正的 doing→done 时计数;第二次结束只刷 result,不算又一次完成。
@@ -3789,8 +3865,9 @@ export const TASK_LIST_OUTPUT_SCHEMA = {
3789
3865
  * 这里的键必须全部在 output.schema 里声明:dsh tools 管线在 execute() 成功返回之后才校验 canonical
3790
3866
  * output,而两个 output.schema 都是 additionalProperties:false 的封闭契约——多带一个未声明字段就会抛
3791
3867
  * ToolOutputError(INVALID_TOOL_OUTPUT),此时 execute() 的副作用(写盘 / 状态迁移)已经生效,
3792
- * 模型侧却只看到调用失败。UI 专用字段(dispatchedSessionId / sessionId / cwd 等)由 buildSnapshot()
3793
- * 的完整任务对象提供,不要加进 taskBrief。回归测试见 test/host.test.mjs。
3868
+ * 模型侧却只看到调用失败。UI 专用字段(dispatchedSessionId / sessionId / cwd / v0.2.9 的
3869
+ * workerSessionId / workerRunState 等)由 buildSnapshot() 的完整任务对象提供,不要加进 taskBrief。
3870
+ * 回归测试见 test/host.test.mjs。
3794
3871
  */
3795
3872
  export function taskBrief(task) {
3796
3873
  return {
@@ -3953,7 +4030,8 @@ export function registerTools(toolCtx, rt) {
3953
4030
  name: 'taskboard_update',
3954
4031
  description:
3955
4032
  '更新看板任务:置为 doing(已派发)、done(审核通过)、todo(打回重做)、archived(归档);' +
3956
- '也可以用 result 写审核结论、assignee 写子 Agent 标识。状态迁移非法时会返回错误。' +
4033
+ '也可以用 result 写审核结论。assignee 只写子 Agent 的 label / 名字(自由文本),**不要写会话 id**——' +
4034
+ '执行会话 id 由宿主记在 workerSessionId,模型写不进去。状态迁移非法时会返回错误。' +
3957
4035
  '需要用户决策时用 needsUser:true + question(可选 questionOptions 选项)在任务上提问,' +
3958
4036
  '看板会把它放进「待你处理」并通知用户回答;needsUser:false 取消提问(问题字段清空,回答留档)。' +
3959
4037
  '任务已归档时不能再提问(返回 conflict):需要用户拍板请先重开该任务或新建一条任务。',
@@ -3965,7 +4043,7 @@ export function registerTools(toolCtx, rt) {
3965
4043
  id: { type: 'string', description: '任务 id,例如 t-3' },
3966
4044
  status: { type: 'string', enum: [...STATUSES], description: '目标状态' },
3967
4045
  result: { type: 'string', description: '审核结论 / 子 Agent 汇报摘要' },
3968
- assignee: { type: 'string', description: '子 Agent 的 label 或会话 id' },
4046
+ assignee: { type: 'string', description: '子 Agent 的 label / 名字(自由文本;不要写会话 id)' },
3969
4047
  note: { type: 'string', description: '备注(覆盖原备注)' },
3970
4048
  needsUser: {
3971
4049
  type: 'boolean',
@@ -3986,6 +4064,9 @@ export function registerTools(toolCtx, rt) {
3986
4064
  async execute(args, exec) {
3987
4065
  if (!args || !args.id) throw new Error('缺少任务 id')
3988
4066
  const patch = {}
4067
+ // v0.2.9(§2):`workerSessionId` / `workerRunState` 是宿主独占字段,**不在白名单里**——
4068
+ // 模型即使传了也进不了 patch(`parameters.additionalProperties:false` 还会在入参校验阶段拒绝),
4069
+ // `applyTaskUpdate` 也不读这两个键,所以任务字段绝不会被模型改写。
3989
4070
  for (const key of ['status', 'result', 'assignee', 'note', 'needsUser', 'question', 'questionOptions']) {
3990
4071
  if (args[key] !== undefined) patch[key] = args[key]
3991
4072
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-dispatch-board",
3
- "version": "0.2.8",
3
+ "version": "0.3.0",
4
4
  "description": "DeepSeek Harness 插件:派单看板 + 派单模式。主 Agent 只拆解/派发/审核/汇报,子 Agent 干活;看板四列(待开始/进行中/已完成/已归档)由轮询自动派发,结论按 Markdown 展示。Dispatcher mode plus a dispatch board for DeepSeek Harness.",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",