@nelsonlongxiang/dsh-open-a2a-net 0.6.28 → 0.6.29

package/nexus-stage/src/wb-chat.ts

@@ -19,7 +19,7 @@
  * @module nexus-stage/wb-chat
  */
 import type { ArchivedRow, DeadRow, PendingRow, RemoteRow, StateBody } from './workbench'
-import { VERDICTS } from './wb-ledger'
+import { overHour, VERDICTS } from './wb-ledger'
 import { displayName } from './stage-name'
 
 /** Chat target: a node picked on the board or in the directory. Session and
@@ -55,8 +55,6 @@ export interface ChatDrawer {
 
 /** The composer's hard limit (dispatch route contract). */
 const MAX_CHARS = 4000
-/** A pending receipt older than this is 陈旧 (same definition as the ledger). */
-const STALE_MS = 60 * 60 * 1000
 /** Within this many px of the bottom, a repaint keeps the thread pinned there. */
 const STICK_PX = 32
 
@@ -415,9 +413,14 @@ export function createChatDrawer(deps: ChatDrawerDeps): ChatDrawer {
   function pendingStatus(row: PendingRow, now: number): SentRow['status'] {
     const inbound = row.direction === 'inbound'
     if (row.receiptExpected === false) return { text: inbound ? '来信 · 无需回执' : '已送达 · 无回执', tone: 'muted', hint: '免回执消息：不等回执，24h 后自动归档' }
-    const stale = now - row.startedAt > STALE_MS
-    const label = inbound ? '待本机回执' : '待回执'
-    return { text: `${stale ? '陈旧' : label} · ${row.status}`, tone: stale ? 'warn' : 'wait', hint: `${inbound ? '对方等待本机回执；' : ''}派发于 ${ago(row.startedAt, now)}` }
+    // One hour boundary with the 台账 tab (the host's settleable verdict,
+    // browser clock only on older hosts). Past it, OUR send is 陈旧 (can be
+    // nudged); a peer's delivery is a receipt WE owe — never 陈旧 (#30 P3).
+    const late = overHour(row, now)
+    const text = inbound ? (late ? '待本机回执 · 超 1 小时' : '待本机回执') : late ? '陈旧' : '待回执'
+    // The row's own status only when it says more than 'pending'.
+    const extra = row.status !== 'pending' ? ` · ${row.status}` : ''
+    return { text: `${text}${extra}`, tone: late ? 'warn' : 'wait', hint: `${inbound ? '对方等待本机回执；' : ''}${inbound ? '收到' : '派发'}于 ${ago(row.startedAt, now)}` }
   }
 
   /** A send that left the ledger, by how it ended (gh#31). `endedBy` says
@@ -427,6 +430,17 @@ export function createChatDrawer(deps: ChatDrawerDeps): ChatDrawer {
    *  ledger's own markers, which are not shown. */
   function settledStatus(row: ArchivedRow, now: number): SentRow['status'] {
     const when = `结算于 ${ago(row.resolvedAt, now)}`
+    // gh#68: a fire-forget send this host moved out of the ledger (移出 on
+    // the 已过期（免回执） card, an abandon) is bookkeeping, not a failure — it
+    // never waited on a receipt, so 已放弃 would contradict the button that
+    // did it. A cancel stays 已撤回: it is a deliberate recall that also
+    // tells the peer to stop (API / tool path; the workbench offers none).
+    // A receipt that arrives after the move keeps its 回执迟到 flag.
+    if (row.receiptExpected === false && row.endedBy === 'abandoned') {
+      return row.late === true
+        ? { text: '已移出（免回执） · 回执迟到', tone: 'warn', hint: `${when}；免回执消息本机移出后对方回执才到，结局不改写` }
+        : { text: '已移出（免回执）', tone: 'muted', hint: `${when}；免回执消息，本机移出台账，不是失败` }
+    }
     if (row.endedBy === 'abandoned' || row.endedBy === 'cancelled') {
       const act = row.endedBy === 'cancelled' ? '撤回' : '放弃'
       // The peer answered after we ended it: the verdict stays ours (late

package/nexus-stage/src/wb-ledger.ts

@@ -25,6 +25,7 @@
  */
 import type { DeadRow, PendingRow, StateBody } from './workbench'
 import type { RailTone } from './wb-rail'
+import { nameInto } from './wb-names'
 
 export interface LedgerContext {
   readonly state: StateBody
@@ -54,7 +55,7 @@ function senderOf(row: { peer?: string }): string | undefined {
  *  settleable verdict (receiptExpected && age < 1h, computed host-side), else
  *  by ours — a workbench opened from another machine with a skewed clock then
  *  still draws the boundary where the server does (at most one poll late). */
-function overHour(r: PendingRow, now: number): boolean {
+export function overHour(r: PendingRow, now: number): boolean {
   return r.settleable !== undefined ? r.settleable === false : now - r.startedAt >= HOUR
 }
 
@@ -155,7 +156,10 @@ export function renderLedger(pane: HTMLElement, ctx: LedgerContext): { badge: st
   const staleCount = facts.stale.length
 
   const tiles = el('div', 'wb-led-tiles')
-  tile(tiles, '待回执', pending.length, '等待回执的任务（pending），含陈旧与免回执行')
+  // 待回执 counts only rows a receipt is owed on — the same rows as the
+  // 陈旧 / 待本机回执 / 等待回执 groups below; receiptless rows are their own
+  // 免回执 group and owe nothing.
+  tile(tiles, '待回执', expected.length, `要回执、仍未结算的任务（含陈旧与本机欠对方的入站行）${receiptless.length > 0 ? `；另有免回执 ${receiptless.length} 条不计` : ''}`)
   tile(tiles, '陈旧', staleCount, '我方派发、要回执、已等待 ≥1h 仍未回执（可催办）；本机欠对方的入站行在「待本机回执」组另计，免回执行不算陈旧', staleCount > 0 ? 'warn' : undefined)
   tile(tiles, '死信', facts.deadLetters.length, '超过 24h TTL 仍未结算（unconsumed）；需清账（abandon）才能移出。免回执到期另列，不算死信', facts.deadLetters.length > 0 ? 'danger' : undefined)
   tile(tiles, '已归档', archived, '已离开台账并留档的任务（结算、拒绝或放弃），用于审计')
@@ -172,8 +176,13 @@ export function renderLedger(pane: HTMLElement, ctx: LedgerContext): { badge: st
     head.appendChild(brief)
     node.appendChild(head)
     const meta = el('div', 'wb-led-meta')
-    meta.appendChild(el('span', 'wb-led-team')).textContent = c.inbound ? `来自 ${c.sender ?? '对端'}` : `发往 ${c.team}`
-    if (c.inbound) meta.appendChild(el('span', 'wb-led-to')).textContent = `至 ${c.team}`
+    // Names, not bare ids (wb-names; the id rides each span's tooltip). An
+    // inbound row's sender is the peer handle; an unknown one reads 对端.
+    const who = meta.appendChild(el('span', 'wb-led-team'))
+    if (!c.inbound) nameInto(who, state, c.team, '发往 ')
+    else if (c.sender !== undefined) nameInto(who, state, c.sender, '来自 ')
+    else who.textContent = '来自 对端'
+    if (c.inbound) nameInto(meta.appendChild(el('span', 'wb-led-to')), state, c.team, '至 ')
     meta.appendChild(el('span')).textContent = c.atText
     meta.appendChild(el('span', 'wb-led-task')).textContent = c.taskId
     for (const chip of c.chips) meta.appendChild(el('span', 'wb-led-chip')).textContent = chip
@@ -181,10 +190,13 @@ export function renderLedger(pane: HTMLElement, ctx: LedgerContext): { badge: st
     node.title = `${c.taskId}\n${c.team}`
     if (c.dead !== undefined) {
       const row = c.dead
-      const btn = el('button', 'wb-btn wb-led-abandon')
+      // A fire-forget expiry is normal bookkeeping, not a failure: moving it
+      // out is an optional tidy, so it gets a quiet control, not 清账.
+      const expiry = row.reason === 'fire-forget'
+      const btn = el('button', `wb-btn wb-led-abandon${expiry ? ' is-quiet' : ''}`)
       btn.type = 'button'
-      btn.textContent = '清账'
-      btn.title = '从台账移出这条死信（abandon）'
+      btn.textContent = expiry ? '移出' : '清账'
+      btn.title = expiry ? '可选：把这条已过期的免回执记录移出台账（不是失败，不处理也无妨）' : '从台账移出这条死信（abandon）'
       btn.addEventListener('click', ev => {
         ev.stopPropagation()
         btn.disabled = true
@@ -209,6 +221,7 @@ export function renderLedger(pane: HTMLElement, ctx: LedgerContext): { badge: st
   const section = (label: string, rows: number, tone: string, hint: string): HTMLElement | null => {
     if (rows === 0) return null
     const g = el('div', `wb-led-group is-${tone}`)
+    g.dataset.group = label
     const head = el('div', 'wb-led-group-head')
     head.appendChild(el('span')).textContent = `${label} · ${rows}`
     head.appendChild(el('span', 'wb-led-group-hint')).textContent = hint

package/nexus-stage/src/wb-names.ts

@@ -0,0 +1,43 @@
+/**
+ * Readable names for routing team ids, shared by the activity and plan
+ * panes and the 台账 tab (review 2026-10-27: rows read bare `dsh/1111…` ids;
+ * the ledger kept doing so after #72 fixed the other two panes).
+ * Names are attacker-shaped data: textContent only.
+ * @module nexus-stage/wb-names
+ */
+import type { StateBody } from './workbench'
+import { displayName } from './stage-name'
+
+/** The name behind a team id — a session, a remote node or a canvas team —
+ *  or undefined when none matches. An empty name counts as no match:
+ *  displayName's `??` keeps '', and a peer can publish one. `remote` marks a
+ *  name the PEER chose — it can collide with a local session's, so callers
+ *  must show where it is from. */
+export function teamName(state: StateBody, team: string): { name: string; remote: boolean } | undefined {
+  const named = (name: string | undefined, remote: boolean) => name !== undefined && name.trim() !== '' ? { name, remote } : undefined
+  const s = (state.sessions ?? []).find(r => r.team === team)
+  if (s !== undefined) return named(displayName(s), false)
+  const r = (state.remote ?? []).find(x => x.team === team)
+  if (r !== undefined) return named(displayName(r), true)
+  return named((state.canvas?.teams ?? []).find(t => t.team === team)?.name, false)
+}
+
+/** A name for plain text: a peer-published one says it is remote. */
+export function teamLabel(state: StateBody, team: string): string {
+  const n = teamName(state, team)
+  return n === undefined ? team : n.remote ? `${n.name}（远端）` : n.name
+}
+
+/** Fill `target` with `prefix` + the name (the id rides the tooltip; an
+ *  unknown team stays its id); a peer-published name gets a visible 远端 chip. */
+export function nameInto(target: HTMLElement, state: StateBody, team: string, prefix = ''): void {
+  const n = teamName(state, team)
+  target.textContent = `${prefix}${n?.name ?? team}`
+  target.title = team
+  if (n?.remote === true) {
+    const chip = target.appendChild(document.createElement('span'))
+    chip.className = 'wb-row-remote'
+    chip.textContent = '远端'
+    chip.title = '名字由对端自行发布'
+  }
+}

package/nexus-stage/src/workbench.css

@@ -31,13 +31,17 @@ body{background:var(--n-bg);color:var(--n-ink);font:13px/1.45 system-ui,"Segoe U
 .wb-header{display:flex;align-items:center;gap:12px;padding:8px 14px;border-bottom:1px solid var(--n-border);background:var(--n-panel)}
 .wb-title{display:flex;align-items:center;gap:10px;font-weight:600;font-size:14px;white-space:nowrap}
 .wb-badge{font-size:11px;font-weight:400;color:var(--n-ink-muted);border:1px solid var(--n-border);border-radius:99px;padding:1px 8px}
+.wb-badge[hidden]{display:none}
+.wb-row-remote{margin-left:6px;padding:0 6px;border:1px solid currentColor;border-radius:99px;font-size:10.5px;color:var(--n-ink-muted);vertical-align:1px}
 .wb-header-stats{display:flex;gap:16px;font-size:12px;color:var(--n-ink-muted);flex-wrap:wrap;min-width:0}
 .wb-header-stats .wb-kv{display:flex;gap:6px}
 .wb-header-stats .wb-kv-k{color:var(--n-ink-muted)}
 .wb-header-stats .wb-kv-v{color:var(--n-ink)}
 /* Header verdict: exceptions only (results-first). Quiet when healthy. */
 .wb-header-ok{color:var(--n-ink-muted)}
-.wb-alert{border:1px solid currentColor;border-radius:99px;padding:0 9px;line-height:20px;white-space:nowrap;cursor:help}
+.wb-alert{border:1px solid currentColor;border-radius:99px;padding:0 9px;line-height:20px;white-space:nowrap;cursor:pointer;background:transparent;font:inherit}
+.wb-alert:hover{background:color-mix(in srgb,currentColor 12%,transparent)}
+.wb-alert:focus-visible{outline:2px solid currentColor;outline-offset:2px}
 .wb-alert-danger{color:var(--n-danger)}
 .wb-alert-warn{color:var(--n-act)}
 .wb-forensics{font-family:ui-monospace,Consolas,monospace;font-size:11px}
@@ -69,7 +73,7 @@ body{background:var(--n-bg);color:var(--n-ink);font:13px/1.45 system-ui,"Segoe U
 .wb-search:focus{outline:1px solid var(--n-accent)}
 .wb-filters{display:flex;flex-wrap:wrap;gap:4px}
 .wb-filter{background:none;border:1px solid var(--n-border);color:var(--n-ink-muted);
-  border-radius:99px;padding:1px 9px;font:inherit;font-size:11.5px;cursor:pointer}
+  border-radius:99px;padding:0 10px;min-height:24px;font:inherit;font-size:11.5px;cursor:pointer}
 .wb-filter:hover{border-color:var(--n-accent);color:var(--n-ink)}
 .wb-filter.is-active{border-color:var(--n-accent);color:var(--n-ink);
   background:color-mix(in srgb,var(--n-accent) 16%,transparent)}
@@ -365,6 +369,8 @@ body{background:var(--n-bg);color:var(--n-ink);font:13px/1.45 system-ui,"Segoe U
 .wb-led-meta > span{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:100%}
 .wb-led-chip{border:1px solid var(--n-border);border-radius:99px;padding:0 6px;font-family:inherit}
 .wb-led-abandon{position:absolute;top:6px;right:6px;margin-left:0;padding:1px 9px;font-size:11.5px}
+.wb-led-abandon.is-quiet{border-color:transparent;background:transparent;color:var(--n-ink-muted)}
+.wb-led-abandon.is-quiet:hover{border-color:var(--n-border);color:var(--n-ink)}
 .wb-led-card:has(.wb-led-abandon) .wb-led-card-head{padding-right:52px}
 .wb-led-empty{padding:24px 8px;text-align:center;font-size:12px;color:var(--n-ink-muted)}
 .wb-led-forensics{font-size:11px;color:var(--n-ink-muted);border-top:1px dashed var(--n-border);padding-top:6px;margin-top:4px}

package/nexus-stage/src/workbench.ts

@@ -22,6 +22,7 @@ import { createChatDrawer, type ChatTarget } from './wb-chat'
 import { createRailTabs } from './wb-rail'
 import { DIRECTORY_FILTERS, learnLogTitle, loadLogTitles, renderDirectory, type DirFilter } from './wb-directory'
 import { ledgerFacts, renderLedger as paintLedger } from './wb-ledger'
+import { nameInto, teamLabel } from './wb-names'
 
 /** One pending ledger row from /state `tasks`. */
 export interface PendingRow {
@@ -72,6 +73,9 @@ export interface ArchivedRow {
   readonly endedBy?: 'receipt' | 'echo' | 'abandoned' | 'cancelled'
   /** A receipt arrived after the caller had already ended the row. */
   readonly late?: boolean
+  /** gh#68: present (false) only when the row never expected a receipt — a
+   *  fire-forget send; absent on receipt-expected rows and older hosts. */
+  readonly receiptExpected?: false
   readonly direction?: 'inbound' | 'outbound'
   readonly brief?: string
 }
@@ -643,6 +647,11 @@ export function createWorkbench(deps: WorkbenchDeps): Workbench {
   }
 
   // ── Activity pane ──
+  /** A team cell: the name when known (wb-names), else the id. */
+  function teamCell(line: HTMLElement, state: StateBody, team: string): void {
+    nameInto(line.appendChild(el('span', 'wb-row-team')), state, team)
+  }
+
   function renderActivity(): void {
     const pane = clear(activityPane)
     if (last === null) return
@@ -659,7 +668,7 @@ export function createWorkbench(deps: WorkbenchDeps): Workbench {
       for (const row of flights) {
         const line = el('div', 'wb-row')
         line.appendChild(el('span', 'wb-row-dir')).textContent = '→'
-        line.appendChild(el('span', 'wb-row-team')).textContent = row.team
+        teamCell(line, last, row.team)
         line.appendChild(el('span', 'wb-row-meta')).textContent = `${row.peer} · ${ageText(row.startedAt, now)}`
         pane.appendChild(line)
       }
@@ -678,7 +687,7 @@ export function createWorkbench(deps: WorkbenchDeps): Workbench {
       dir.textContent = row.dir === 'out' ? '→' : '←'
       if (row.ok !== true) dir.classList.add('is-fail')
       line.appendChild(dir)
-      line.appendChild(el('span', 'wb-row-team')).textContent = row.team
+      teamCell(line, last, row.team)
       line.appendChild(el('span', 'wb-row-meta')).textContent = `${row.peer} · ${ageText(row.ts, now)}`
       line.appendChild(el('span', 'wb-row-badges')).textContent = row.ok === true ? '' : '失败'
       pane.appendChild(line)
@@ -704,18 +713,24 @@ export function createWorkbench(deps: WorkbenchDeps): Workbench {
       const subject = row.brief === undefined || row.brief === '' ? '' : `「${row.brief}」`
       actions.push({
         severity: 'normal',
-        text: `催办 ${row.taskId} → ${row.team}（等待 ${ageText(row.startedAt, now)} 无回执）${subject}`,
+        text: `催办 ${row.taskId} → ${teamLabel(state, row.team)}（等待 ${ageText(row.startedAt, now)} 无回执）${subject}`,
         brief: `a2a_route 催收回执：task ${row.taskId}（team ${row.team}）${subject === '' ? '' : `原任务「${row.brief}」`}已派发 ${ageText(row.startedAt, now)}，请回报结果或回执。`,
       })
     }
-    for (const row of state.sessions ?? []) {
-      if (row.live !== true) {
-        actions.push({ severity: 'normal', text: `冷会话 ${displayName(row)}：在 GUI 打开该会话即可唤醒加入面` })
-      }
+    // Cold sessions are one action, not one per session: they share the same
+    // remedy (open them in the GUI), and a list of identical lines buried the
+    // actions that differ.
+    const cold = (state.sessions ?? []).filter(row => row.live !== true).map(row => displayName(row))
+    if (cold.length > 0) {
+      const names = cold.slice(0, 3).join('、') + (cold.length > 3 ? ` 等 ${cold.length} 个` : '')
+      actions.push({ severity: 'normal', text: `冷会话 ${cold.length} 个（${names}）：在 GUI 打开即可唤醒加入面` })
     }
     for (const row of state.reconcile?.rows ?? []) {
       if (row.needsRepair === true) {
-        actions.push({ severity: 'high', text: `reconcile 需修复：${row.id} ${row.error}` })
+        // Name the session; the id stays for the operator who greps logs.
+        const s = (state.sessions ?? []).find(x => x.id === row.id)
+        const who = s !== undefined ? `${displayName(s)}（${row.id}）` : row.id
+        actions.push({ severity: 'high', text: `reconcile 需修复：${who} ${row.error}` })
       }
     }
     const conflicts = state.idempotency?.conflicts ?? 0
@@ -1122,35 +1137,58 @@ export function createWorkbench(deps: WorkbenchDeps): Workbench {
   // forensic counters that used to sit here (idempotency claims/replays,
   // reconcile state) read on the ledger's 取证 line instead.
   function renderHeader(): void {
-    versionBadge.textContent = last?.version !== undefined ? `v${last.version}` : 'v?'
+    // An unknown version says nothing: hide the badge rather than print 'v?'.
+    versionBadge.textContent = last?.version !== undefined ? `v${last.version}` : ''
+    versionBadge.hidden = last?.version === undefined
     const box = clear(headerStats)
     if (last === null) return
-    const alerts: Array<{ text: string; tone: 'warn' | 'danger'; title: string }> = []
+    // Each pill is a way in: it opens the tab (and ledger group) that holds
+    // the rows behind its count.
+    const alerts: Array<{ text: string; tone: 'warn' | 'danger'; title: string; tab: 'ledger' | 'plan' | 'activity'; group?: string }> = []
     // Same definitions as the 台账 tab (wb-ledger ledgerFacts): fire-forget
     // expiries are not dead letters, receiptless rows are never stale.
     const facts = ledgerFacts(last, deps.now())
     const dead = facts.deadLetters.length
-    if (dead > 0) alerts.push({ text: `死信 ${dead}`, tone: 'danger', title: '超过 24h TTL 仍未结算的任务（unconsumed），需在台账清账' })
+    if (dead > 0) alerts.push({ text: `死信 ${dead}`, tone: 'danger', title: '超过 24h TTL 仍未结算的任务（unconsumed），需在台账清账', tab: 'ledger', group: '死信' })
     const stale = facts.stale.length
-    if (stale > 0) alerts.push({ text: `陈旧 ${stale}`, tone: 'warn', title: '我方派发、要回执、已等待 ≥1h 仍未回执（可催办；免回执行不算）' })
+    if (stale > 0) alerts.push({ text: `陈旧 ${stale}`, tone: 'warn', title: '我方派发、要回执、已等待 ≥1h 仍未回执（可催办；免回执行不算）', tab: 'ledger', group: '陈旧' })
     const owed = facts.owedOverdue.length
-    if (owed > 0) alerts.push({ text: `欠回执 ${owed}`, tone: 'warn', title: '对方投递给本机、已等待本机回执超过 1 小时' })
+    if (owed > 0) alerts.push({ text: `欠回执 ${owed}`, tone: 'warn', title: '对方投递给本机、已等待本机回执超过 1 小时', tab: 'ledger', group: '待本机回执' })
     const conflicts = last.idempotency?.conflicts ?? 0
-    if (conflicts > 0) alerts.push({ text: `幂等冲突 ${conflicts}`, tone: 'danger', title: '同一幂等键对应了不同载荷，需人工核查' })
+    if (conflicts > 0) alerts.push({ text: `幂等冲突 ${conflicts}`, tone: 'danger', title: '同一幂等键对应了不同载荷，需人工核查', tab: 'ledger', group: '取证' })
     const repair = (last.reconcile?.rows ?? []).filter(row => row.needsRepair === true).length
-    if (repair > 0) alerts.push({ text: `需修复 ${repair}`, tone: 'danger', title: 'reconcile 无法自动恢复的会话，见行动计划' })
+    if (repair > 0) alerts.push({ text: `需修复 ${repair}`, tone: 'danger', title: 'reconcile 无法自动恢复的会话，见行动计划', tab: 'plan' })
     if (alerts.length === 0) {
       box.appendChild(el('span', 'wb-header-ok')).textContent = '● 无异常'
       return
     }
     for (const a of alerts) {
-      const pill = el('span', `wb-alert wb-alert-${a.tone}`)
+      const pill = el('button', `wb-alert wb-alert-${a.tone}`)
+      pill.type = 'button'
       pill.textContent = a.text
-      pill.title = a.title
+      pill.title = `${a.title}（点击查看）`
+      pill.addEventListener('click', () => openAlert(a.tab, a.group))
       box.appendChild(pill)
     }
   }
 
+  /** Open the pane behind a header pill. With the board up the panes are
+   *  rail tabs (on a narrow screen the rail slides in first); without it they
+   *  sit on the stage. A ledger group (or the 取证 fold) scrolls into view. */
+  function openAlert(tab: 'ledger' | 'plan' | 'activity', group?: string): void {
+    const pane = dataPanes.find(([k]) => k === tab)![1]
+    if (mode === 'canvas') {
+      root.classList.add('is-rail-open')
+      railTabs.select(tab, { focus: false })
+    }
+    const target = group === undefined ? pane
+      : group === '取证' ? pane.querySelector<HTMLDetailsElement>('details.wb-led-forensics')
+        : Array.from(pane.querySelectorAll<HTMLElement>('.wb-led-group')).find(g => g.dataset.group === group) ?? null
+    if (target === null) return
+    if (target instanceof HTMLDetailsElement) target.open = true
+    target.scrollIntoView?.({ block: 'start', behavior: 'smooth' })
+  }
+
   function update(state: StateBody | null): void {
     last = state
     // 0.6.12: refresh the readable-log list opportunistically (single flight;

package/nexus-stage/src/world.ts

@@ -153,7 +153,7 @@ export function planSeatClear(sid: string, occupied: ReadonlyArray<{ readonly x:
 }
 
 /** Minimal session row shape the model needs (topology.SessionRow satisfies it). */
-export interface SessionLite { id: string; label: string; team: string; name?: string; joined: boolean; live?: boolean; teams?: readonly string[] }
+export interface SessionLite { id: string; label: string; team: string; name?: string; description?: string; joined: boolean; live?: boolean; teams?: readonly string[] }
 
 /** Minimal team shape (topology.CanvasTeam satisfies it). `team` is the
  * mono route alias `<host>/canvas/<name>` when the payload carries it. */
@@ -172,6 +172,8 @@ export interface WorldNode {
   /** The route alias `<team>/<id8>` the state payload provides. */
   team: string
   name?: string
+  /** What the session is for (/state `description`) — the card's second line. */
+  description?: string
   live: boolean
   /** Peer node (PR D v1 ruling): a remote host entry rendered as a card.
    *  Excluded from local content bounds; canvas memberships allowed since
@@ -338,6 +340,7 @@ export class WorldModel {
     }
     existing.label = n.label
     existing.name = n.name
+    existing.description = n.description
     existing.live = n.live
     existing.memberships = n.memberships
     this.bump()
@@ -479,6 +482,7 @@ export class WorldModel {
         label: s.label,
         team: s.team,
         name: s.name,
+        description: s.description,
         live: s.live !== false,
         memberships: memberships.get(s.id) ?? [],
       })