@khorsheed/dsh-room 0.1.0

package/lib/types/client/locales.js

@@ -0,0 +1,413 @@
+/** `room` namespace dictionaries. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export const zh = {
+    'recovery.title': '中断的对话需要对账',
+    'recovery.help': '重启前的结果尚未确认，不会自动重试。请查看成员会话并填写核对结论；对账后，已排队的普通对话可以继续，正式目标仍遵守暂停状态。',
+    'recovery.done': '确认已完成',
+    'recovery.cancelled': '确认放弃本次执行',
+    'plan.budgetHelp': '这些限制由整个目标共享，不按成员各算一份。任务派发时就占用一次，首次执行、重试和返工均计入；普通聊天不占用这个目标的次数。',
+    'plan.create': '设定正式目标',
+    'plan.objective': '目标',
+    'plan.execute': '开始推进（不勾选则只保存草稿）',
+    'plan.start': '开始推进',
+    'plan.saveDraft': '保存草稿',
+    'plan.parallel': '目标内同时执行的任务数',
+    'plan.attempts': '整个目标的总执行次数',
+    'plan.perTask': '每项任务最多执行次数',
+    'plan.minutes': '目标推进时长上限（分钟）',
+    'plan.reason': '结论或原因',
+    'plan.references': '证据引用（每行一项）',
+    'plan.artifacts': '实际成果位置（每行一项）',
+    'plan.attempt': '尝试',
+    'plan.group': '任务组',
+    'plan.parent': '所属分组',
+    'plan.criteria': '验收标准',
+    'plan.inputs': '输入引用',
+    'plan.expectedArtifacts': '预期成果位置',
+    'plan.dependencies': '等待验收',
+    'plan.session': '打开成员会话',
+    'plan.reconcile': '对账',
+    'plan.review': '验收 / 返工',
+    'plan.retry': '重试',
+    'plan.accept': '验收通过',
+    'plan.rework': '退回返工',
+    'plan.reconcileSubmitted': '对账为待验收',
+    'plan.reconcileFailed': '对账为失败',
+    'plan.acceptedCount': '已验收 {done} / 当前计划 {total} 项',
+    'plan.revision': '计划版本',
+    'plan.humanPause': '人类暂停自动推进',
+    'plan.pause': '暂停自动推进',
+    'plan.resume': '继续推进',
+    'plan.goalControls': '目标验收与预算',
+    'plan.updateBudget': '更新预算',
+    'plan.complete': '验收目标完成',
+    'plan.cancel': '取消目标（当前轮继续结束）',
+    'plan.status.draft': '草稿',
+    'plan.status.running': '执行中',
+    'plan.status.paused': '已暂停',
+    'plan.status.completed': '目标已完成',
+    'plan.status.cancelled': '已取消',
+    'plan.status.pending': '等待派发或前置验收',
+    'plan.status.submitted': '待验收',
+    'plan.status.accepted': '已验收',
+    'plan.status.failed': '失败',
+    'plan.status.queued': '排队中',
+    'plan.status.rejected': '已退回返工',
+    'plan.status.uncertain': '结果未知，需对账',
+    'coordinator.cwdBound': '成员已绑定会话或有排队工作；请邀请新成员使用其他目录',
+    'coordinator.nativeRequired': '保留原生 DSH 成员，以便单独联系或切回协调者',
+    'coordinator.label': '协调者',
+    'coordinator.promote': '设为协调者',
+    'coordinator.busy': '请等待原协调者与候选成员空闲、队列清空后交接',
+    'coordinator.conflict': '协调者已改变，请刷新后重试',
+    'coordinator.active': '请先交接协调者，再移除此成员',
+    'coordinator.configuration': '已启动成员的模型和 effort 由成员配置面板管理',
+    'action.inviteAgent': '＋ 邀请 agent',
+    'view.members': '成员',
+    'members.empty': '暂无成员',
+    'composer.placeholder': '跟协调者对话；@ 指定其他成员',
+    'composer.send': '发送',
+    'composer.stop': '停止生成',
+    'composer.error.unknownTargets': '未知成员：{names}',
+    'composer.error.generic': '发送失败，请重试',
+    'composer.model.picker': 'DSH 模型',
+    'composer.model.select': '选择模型',
+    'composer.model.loading': '正在加载模型…',
+    'composer.model.menu.model': '模型',
+    'composer.model.menu.effort': '推理等级',
+    'composer.model.effortDefault': '默认',
+    'composer.model.status.loading': '正在刷新模型列表…',
+    'composer.model.empty': '没有可用的模型',
+    'composer.model.emptyEfforts': '当前模型未提供推理等级',
+    'composer.model.failed': '切换模型失败，请重试',
+    'todo.title': '任务',
+    'todo.progress.done': '{done} 已完成',
+    'todo.progress.active': '{active} 进行中',
+    'todo.progress.pending': '{pending} 待处理',
+    'queue.count': '{n} 条排队消息',
+    'member.kind.main': '原生 DSH',
+    'action.copy': '复制',
+    'action.copied': '已复制',
+    'markdown.footnotes': '脚注',
+    'speech.stopped': '已停止 · 部分输出',
+    'speech.failed': '失败 · 部分输出',
+    'speech.jump': '查看成员会话',
+    'speech.expand': '展开全部',
+    'speech.collapse': '收起',
+    'run.working': '{member} 正在工作…',
+    'run.failed': '{member} 运行失败',
+    'run.stop': '停止',
+    'run.durationUnknown': '耗时未知',
+    'event.joined': '{member}（{provider}）加入了 room',
+    'event.joinedByAgent': ' · 由主 agent 邀请',
+    'event.left': '{member} 离开了 room',
+    'relay.line': '⇢ {from} → {to}：{content}',
+    'relay.confirm': '确认派发',
+    'relay.dismiss': '忽略',
+    'relay.state.confirmed': '（已确认，派发中）',
+    'relay.state.dismissed': '（已忽略）',
+    'relay.state.sent': '（已送达）',
+    'tasks.capsule': '当前进度',
+    'tasks.chat': '聊天任务',
+    'tasks.doing': '在做',
+    'tasks.filter.all': '全部',
+    'tasks.blocked': '等 {member}',
+    'tasks.status.pending': '待开始',
+    'tasks.status.in_progress': '进行中',
+    'tasks.status.done': '已完成',
+    'tasks.status.cancelled': '已取消',
+    'tasks.status.failed': '失败',
+    'tasks.close': '完成',
+    'tasks.dismiss': '关闭',
+    'tasks.add': '添加',
+    'tasks.addMember': '任务成员',
+    'tasks.addPlaceholder': '新任务…',
+    'tasks.addBlockedBy': '等待成员（可选）',
+    'tasks.addBlockedByNone': '不等谁',
+    'tasks.addTrigger': '添加任务',
+    'goal.label': '目标',
+    'goal.set': '＋ 设定目标',
+    'goal.placeholder': '本房间的目标…',
+    'goal.edit': '编辑',
+    'goal.save': '保存',
+    'goal.cancel': '取消',
+    'goal.recent': '推进记录',
+    'goal.noAdvances': '暂无推进记录',
+    'advance.line': '✓ {member} 完成了「{title}」',
+    'advance.progress': '── 目标进度 {done}/{total}',
+    'time.justNow': '刚刚',
+    'time.minutesAgo': '{count} 分钟前',
+    'time.hoursAgo': '{count} 小时前',
+    'time.daysAgo': '{count} 天前',
+    'stats.counts': '{turns} 轮 · {steps} 步',
+    'stats.llm': 'LLM {duration}',
+    'stats.toolCall': '工具调用 {duration}',
+    'stats.ttftAverage': '首 token 平均 {duration}',
+    'stats.tokensPerSecond': '{throughput} tok/s',
+    'stats.cacheHit': '缓存命中 {percent}%',
+    'stats.tokens': '输入 {input} tok · 输出 {output} tok',
+    'members.notRoomTitle': '把会话变成多 agent 协作间',
+    'members.notRoom': '邀请 agent 进来即可开始协作：各自独立会话，@ 派发任务，共享目标与任务板',
+    'members.notRoomAction': '邀请 agent',
+    'members.status.idle': '空闲',
+    'members.status.running': '运行中',
+    'members.status.failed': '失败',
+    'members.trajectory': '轨迹→',
+    'members.model.default': '默认',
+    'members.instructions.empty': '未设置角色',
+    'members.instructions.expand': '展开',
+    'members.instructions.collapse': '收起',
+    'members.edit': '编辑',
+    'members.remove': '移除',
+    'members.removeConfirm': '确定移除 {member}？其运行将被中断，历史记录保留。',
+    'members.invite': '＋ 邀请成员',
+    'invite.title': '邀请成员',
+    'invite.title.edit': '编辑 {member}',
+    'invite.provider': 'Provider',
+    'invite.name': '称呼（@ 寻址名）',
+    'invite.nameHint': '唯一、无空白、不含 @',
+    'invite.randomName': '随机起名',
+    'invite.preview': '预览',
+    'invite.previewName': '新成员',
+    'invite.advanced': '高级设置',
+    'invite.cwd': '工作目录（可选）',
+    'invite.cwdHint': '留空 = 继承 room 会话的工作目录（占位符所示）',
+    'invite.browse': '浏览…',
+    'invite.browseFailed': '目录选择器不可用（主机未提供 native 选择能力）',
+    'invite.cwdReset': '清除，恢复继承',
+    'invite.instructions': '角色指令',
+    'invite.instructionsHint': '会拼在给它的第一条任务消息最前面，之后可编辑；留空则不带预设，成员入列后可随时 @ 它安排任务',
+    'invite.instructionsHintEdit': '之后的每次派发都带这份指令；清空 = 不再注入任何预设',
+    'invite.instructionsPlaceholder': '你是这个 room 的后端工程师，负责 API 设计，回答保持简洁…',
+    'invite.firstTask': '首个任务（可选）',
+    'invite.firstTaskHint': '留空则成员入列待命',
+    'invite.model': '默认模型',
+    'invite.modelPlaceholder': '留空 = 跟随该 provider 的默认模型',
+    'invite.modelPlaceholderDefault': '跟随该 provider 默认：{model}',
+    'invite.modelPlaceholderEdit': '留空 = 清除覆盖，跟随设置',
+    'invite.modelMenu': '选择模型',
+    'invite.modelDefaultItem': '默认（跟随该 provider 默认）',
+    'invite.modelDefaultItemNamed': '默认（跟随该 provider 默认：{model}）',
+    'invite.modelDefaultItemEdit': '默认（清除覆盖，跟随设置）',
+    'invite.modelHint': '记进本次委派，exec 与 live 都在启动时生效；入列后也可在成员会话里切换',
+    'invite.modelHintEdit': '预填当前生效模型；保存即切换该成员的会话级模型（live 成员下一轮以新模型重 spawn）并记进名册；成员有一轮在飞时切换会被拒绝并在下方显示',
+    'invite.cancel': '取消',
+    'invite.submit': '邀请入队',
+    'invite.save': '保存',
+    'invite.loginHint': '置灰的 provider 未登录——请先登录该 provider',
+    'invite.loggedOut': '（未登录）',
+    'invite.facadeMissing': 'local-agent 委派门面未挂载——CLI 成员暂不可邀请（主 agent 成员不受影响）',
+    'invite.error.duplicate': '名字已被占用',
+    'invite.error.invalid': '名字需非空、无空白、不含 @',
+    'invite.error.unavailable': 'local-agent 委派门面不可用',
+    'invite.error.unknownProvider': '未知 provider：{provider}（可用：{available}）',
+    'invite.error.generic': '操作失败，请重试',
+    'invite.success.task': '已邀请 {member} 并开始工作',
+    'invite.success.idle': '{member} 已加入 room',
+};
+/** English dictionary, checked complete against the zh key set. */
+export const en = {
+    'recovery.title': 'Interrupted conversations need reconciliation',
+    'recovery.help': 'The pre-restart outcome is unknown and will not be retried automatically. Inspect the member session and record your finding. Reconciliation releases queued ordinary conversations; paused goals remain paused.',
+    'recovery.done': 'Confirm completed',
+    'recovery.cancelled': 'Abandon this execution',
+    'plan.budgetHelp': 'Limits apply to the whole goal, not separately to each member. A dispatch reserves one execution, including the first run, retries and rework; ordinary chat does not consume this goal budget.',
+    'plan.create': 'Set a formal goal',
+    'plan.objective': 'Goal',
+    'plan.execute': 'Start execution (otherwise save a draft only)',
+    'plan.start': 'Start execution',
+    'plan.saveDraft': 'Save draft',
+    'plan.parallel': 'Concurrent tasks in this goal',
+    'plan.attempts': 'Total executions across this goal',
+    'plan.perTask': 'Maximum executions per task',
+    'plan.minutes': 'Active time limit (minutes)',
+    'plan.reason': 'Decision or reason',
+    'plan.references': 'Evidence references (one per line)',
+    'plan.artifacts': 'Actual artifact locations (one per line)',
+    'plan.attempt': 'Attempt',
+    'plan.group': 'Task group',
+    'plan.parent': 'Parent group',
+    'plan.criteria': 'Acceptance criteria',
+    'plan.inputs': 'Input references',
+    'plan.expectedArtifacts': 'Expected artifacts',
+    'plan.dependencies': 'Awaiting acceptance',
+    'plan.session': 'Open member session',
+    'plan.reconcile': 'Reconcile',
+    'plan.review': 'Review / rework',
+    'plan.retry': 'Retry',
+    'plan.accept': 'Accept result',
+    'plan.rework': 'Request rework',
+    'plan.reconcileSubmitted': 'Reconcile as submitted',
+    'plan.reconcileFailed': 'Reconcile as failed',
+    'plan.acceptedCount': 'Accepted {done} / current plan {total}',
+    'plan.revision': 'Plan revision',
+    'plan.humanPause': 'Human paused automatic progress',
+    'plan.pause': 'Pause automatic progress',
+    'plan.resume': 'Continue execution',
+    'plan.goalControls': 'Goal review and budget',
+    'plan.updateBudget': 'Update budget',
+    'plan.complete': 'Accept goal completion',
+    'plan.cancel': 'Cancel goal (current rounds can finish)',
+    'plan.status.draft': 'Draft',
+    'plan.status.running': 'Running',
+    'plan.status.paused': 'Paused',
+    'plan.status.completed': 'Goal completed',
+    'plan.status.cancelled': 'Cancelled',
+    'plan.status.pending': 'Awaiting dispatch or prerequisite review',
+    'plan.status.submitted': 'Awaiting review',
+    'plan.status.accepted': 'Accepted',
+    'plan.status.failed': 'Failed',
+    'plan.status.queued': 'Queued',
+    'plan.status.rejected': 'Rework requested',
+    'plan.status.uncertain': 'Unknown outcome; reconcile',
+    'coordinator.cwdBound': 'This member has a bound session or queued work; invite a new member for another directory',
+    'coordinator.nativeRequired': 'Keep the native DSH member available for direct messages and coordinator handoff',
+    'coordinator.label': 'Coordinator',
+    'coordinator.promote': 'Set as coordinator',
+    'coordinator.busy': 'Wait for both coordinators to be idle with empty queues before handoff',
+    'coordinator.conflict': 'Coordinator changed; refresh and retry',
+    'coordinator.active': 'Hand off coordination before removing this member',
+    'coordinator.configuration': 'Use member controls to change a started member model or effort',
+    'action.inviteAgent': '＋ Invite agent',
+    'view.members': 'Members',
+    'members.empty': 'No members yet',
+    'composer.placeholder': 'Talk to the main agent; @ a member to dispatch',
+    'composer.send': 'Send',
+    'composer.stop': 'Stop generating',
+    'composer.error.unknownTargets': 'Unknown members: {names}',
+    'composer.error.generic': 'Could not send; please retry',
+    'composer.model.picker': 'Main agent model',
+    'composer.model.select': 'Select model',
+    'composer.model.loading': 'Loading models…',
+    'composer.model.menu.model': 'Model',
+    'composer.model.menu.effort': 'Effort',
+    'composer.model.effortDefault': 'Default',
+    'composer.model.status.loading': 'Refreshing model list…',
+    'composer.model.empty': 'No models available',
+    'composer.model.emptyEfforts': 'This model provides no reasoning effort levels',
+    'composer.model.failed': 'Could not switch the model; try again',
+    'todo.title': 'To-dos',
+    'todo.progress.done': '{done} completed',
+    'todo.progress.active': '{active} in progress',
+    'todo.progress.pending': '{pending} pending',
+    'queue.count': '{n} queued messages',
+    'member.kind.main': 'Native DSH',
+    'action.copy': 'Copy',
+    'action.copied': 'Copied',
+    'markdown.footnotes': 'Footnotes',
+    'speech.stopped': 'Stopped · partial output',
+    'speech.failed': 'Failed · partial output',
+    'speech.jump': 'Open the member session',
+    'speech.expand': 'Show all',
+    'speech.collapse': 'Show less',
+    'run.working': '{member} is working…',
+    'run.failed': "{member}'s run failed",
+    'run.stop': 'Stop',
+    'run.durationUnknown': 'Duration unknown',
+    'event.joined': '{member} ({provider}) joined the room',
+    'event.joinedByAgent': ' · invited by the main agent',
+    'event.left': '{member} left the room',
+    'relay.line': '⇢ {from} → {to}: {content}',
+    'relay.confirm': 'Confirm',
+    'relay.dismiss': 'Dismiss',
+    'relay.state.confirmed': '(confirmed, dispatching)',
+    'relay.state.dismissed': '(dismissed)',
+    'relay.state.sent': '(delivered)',
+    'tasks.capsule': 'Progress',
+    'tasks.chat': 'Chat tasks',
+    'tasks.doing': 'doing',
+    'tasks.filter.all': 'All',
+    'tasks.blocked': 'waiting on {member}',
+    'tasks.status.pending': 'pending',
+    'tasks.status.in_progress': 'in progress',
+    'tasks.status.done': 'done',
+    'tasks.status.cancelled': 'cancelled',
+    'tasks.status.failed': 'failed',
+    'tasks.close': 'Done',
+    'tasks.dismiss': 'Dismiss',
+    'tasks.add': 'Add',
+    'tasks.addMember': 'Task member',
+    'tasks.addPlaceholder': 'New task…',
+    'tasks.addBlockedBy': 'Waiting on (optional)',
+    'tasks.addBlockedByNone': 'Not waiting',
+    'tasks.addTrigger': 'Add task',
+    'goal.label': 'Goal',
+    'goal.set': '＋ Set a goal',
+    'goal.placeholder': "The room's goal…",
+    'goal.edit': 'Edit',
+    'goal.save': 'Save',
+    'goal.cancel': 'Cancel',
+    'goal.recent': 'Advances',
+    'goal.noAdvances': 'No advances yet',
+    'advance.line': '✓ {member} finished "{title}"',
+    'advance.progress': '── goal {done}/{total}',
+    'time.justNow': 'just now',
+    'time.minutesAgo': '{count}m ago',
+    'time.hoursAgo': '{count}h ago',
+    'time.daysAgo': '{count}d ago',
+    'stats.counts': '{turns} turns · {steps} steps',
+    'stats.llm': 'LLM {duration}',
+    'stats.toolCall': 'Tool call {duration}',
+    'stats.ttftAverage': 'TTFT avg {duration}',
+    'stats.tokensPerSecond': '{throughput} tok/s',
+    'stats.cacheHit': 'Cache hit {percent}%',
+    'stats.tokens': 'Input {input} tok · Output {output} tok',
+    'members.notRoomTitle': 'Turn this session into a multi-agent room',
+    'members.notRoom': 'Invite an agent to start collaborating: independent sessions, @-dispatched tasks, a shared goal and task board',
+    'members.notRoomAction': 'Invite agent',
+    'members.status.idle': 'idle',
+    'members.status.running': 'running',
+    'members.status.failed': 'failed',
+    'members.trajectory': 'trace→',
+    'members.model.default': 'Default',
+    'members.instructions.empty': 'No role set',
+    'members.instructions.expand': 'More',
+    'members.instructions.collapse': 'Less',
+    'members.edit': 'Edit',
+    'members.remove': 'Remove',
+    'members.removeConfirm': 'Remove {member}? Its run will be interrupted; the history is kept.',
+    'members.invite': '＋ Invite member',
+    'invite.title': 'Invite member',
+    'invite.title.edit': 'Edit {member}',
+    'invite.provider': 'Provider',
+    'invite.name': 'Name (@-addressing)',
+    'invite.nameHint': 'unique, no whitespace, no "@"',
+    'invite.randomName': 'Roll a random name',
+    'invite.preview': 'Preview',
+    'invite.previewName': 'new-member',
+    'invite.advanced': 'Advanced',
+    'invite.cwd': 'Working directory (optional)',
+    'invite.cwdHint': 'Empty: inherits the room session\'s cwd (shown as the placeholder)',
+    'invite.browse': 'Browse…',
+    'invite.browseFailed': 'The directory picker is unavailable (the host serves no native picking capability)',
+    'invite.cwdReset': 'Clear; inherit again',
+    'invite.instructions': 'Role instructions',
+    'invite.instructionsHint': 'Prepended to the front of the first task message the member receives; editable later. Empty: no preset — once the member joins, @ it any time to hand out work',
+    'invite.instructionsHintEdit': 'Every later dispatch carries these instructions; clearing them stops the injection',
+    'invite.instructionsPlaceholder': 'You are this room\'s backend engineer, own the API design, keep answers concise…',
+    'invite.firstTask': 'First task (optional)',
+    'invite.firstTaskHint': 'Empty: the member joins idle',
+    'invite.model': 'Default model',
+    'invite.modelPlaceholder': 'Empty: follow the provider\'s default model',
+    'invite.modelPlaceholderDefault': 'Follow the provider default: {model}',
+    'invite.modelPlaceholderEdit': 'Empty: clear the override, follow settings',
+    'invite.modelMenu': 'Pick a model',
+    'invite.modelDefaultItem': 'Default (follow the provider default)',
+    'invite.modelDefaultItemNamed': 'Default (follow the provider default: {model})',
+    'invite.modelDefaultItemEdit': 'Default (clear the override, follow settings)',
+    'invite.modelHint': 'Recorded with the delegation, bound at spawn for exec and live alike; switchable later in the member session',
+    'invite.modelHintEdit': 'Prefilled with the effective model; saving switches the member\'s session-level model (a live member respawns onto it next round) and records it on the roster; a switch is refused while a round is in flight (shown below)',
+    'invite.cancel': 'Cancel',
+    'invite.submit': 'Invite to the team',
+    'invite.save': 'Save',
+    'invite.loginHint': 'Greyed providers are logged out — log in to the provider first',
+    'invite.loggedOut': ' (logged out)',
+    'invite.facadeMissing': 'The local-agent delegation facade is not mounted — CLI members cannot be invited (the main-agent member is unaffected)',
+    'invite.error.duplicate': 'That name is taken',
+    'invite.error.invalid': 'Names must be non-empty, without whitespace or "@"',
+    'invite.error.unavailable': 'The local-agent delegation facade is unavailable',
+    'invite.error.unknownProvider': 'Unknown provider: {provider} (available: {available})',
+    'invite.error.generic': 'The operation failed; please retry',
+    'invite.success.task': '{member} invited and working',
+    'invite.success.idle': '{member} joined the room',
+};

package/lib/types/client/member-color.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fixed per-member colors: the one new visual vocabulary the room adds (the
+ * identity dot on member rows, speech headers, and @-candidates). Assignment
+ * is a stable name hash — the same member keeps its color across views and
+ * reloads without any roster bookkeeping.
+ */
+/**
+ * Map a member name to its fixed palette color.
+ * @param name - the member's addressing name.
+ * @returns a hex color.
+ */
+export declare function memberColor(name: string): string;
+//# sourceMappingURL=member-color.d.ts.map

package/lib/types/client/member-color.js

@@ -0,0 +1,22 @@
+/**
+ * Fixed per-member colors: the one new visual vocabulary the room adds (the
+ * identity dot on member rows, speech headers, and @-candidates). Assignment
+ * is a stable name hash — the same member keeps its color across views and
+ * reloads without any roster bookkeeping.
+ */
+/** Eight hues chosen to stay legible on both light and dark surfaces. */
+const PALETTE = [
+    '#5b8ff9', '#61ddaa', '#f6bd16', '#7262fd',
+    '#f6903d', '#008685', '#e86452', '#f08bb4',
+];
+/**
+ * Map a member name to its fixed palette color.
+ * @param name - the member's addressing name.
+ * @returns a hex color.
+ */
+export function memberColor(name) {
+    let hash = 0;
+    for (const char of name)
+        hash = (hash * 31 + (char.codePointAt(0) ?? 0)) >>> 0;
+    return PALETTE[hash % PALETTE.length];
+}

package/lib/types/client/name-pool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The invite dialog's name dice: a small game-flavored pool of addressing
+ * names. Rolling skips names already on the roster (a duplicate would fail
+ * the host's uniqueness check anyway) and the currently displayed name (a
+ * roll that changes nothing feels broken). The avatar color follows the new
+ * name automatically — it is a name hash (member-color.ts).
+ */
+/** Game-flavored addressing names, one per letter for variety. */
+export declare const NAME_POOL: readonly ['ada', 'bill', 'cathy', 'dex', 'echo', 'faye', 'gray', 'iris', 'jude', 'kai', 'luna', 'milo', 'nova', 'odin', 'piper', 'quinn', 'ray', 'sage', 'tess', 'uma', 'vale', 'wren', 'xavi', 'yara', 'zoe'];
+/**
+ * Roll a random name from the pool.
+ * @param taken - names already on the roster (never rolled).
+ * @param current - the currently displayed name (never re-rolled).
+ * @returns a fresh name, or undefined when the pool is exhausted.
+ */
+export declare function rollName(taken: readonly string[], current: string): string | undefined;
+//# sourceMappingURL=name-pool.d.ts.map

package/lib/types/client/name-pool.js

@@ -0,0 +1,25 @@
+/**
+ * The invite dialog's name dice: a small game-flavored pool of addressing
+ * names. Rolling skips names already on the roster (a duplicate would fail
+ * the host's uniqueness check anyway) and the currently displayed name (a
+ * roll that changes nothing feels broken). The avatar color follows the new
+ * name automatically — it is a name hash (member-color.ts).
+ */
+/** Game-flavored addressing names, one per letter for variety. */
+export const NAME_POOL = [
+    'ada', 'bill', 'cathy', 'dex', 'echo', 'faye', 'gray', 'iris',
+    'jude', 'kai', 'luna', 'milo', 'nova', 'odin', 'piper', 'quinn',
+    'ray', 'sage', 'tess', 'uma', 'vale', 'wren', 'xavi', 'yara', 'zoe',
+];
+/**
+ * Roll a random name from the pool.
+ * @param taken - names already on the roster (never rolled).
+ * @param current - the currently displayed name (never re-rolled).
+ * @returns a fresh name, or undefined when the pool is exhausted.
+ */
+export function rollName(taken, current) {
+    const candidates = NAME_POOL.filter(name => !taken.includes(name) && name !== current);
+    if (candidates.length === 0)
+        return undefined;
+    return candidates[Math.floor(Math.random() * candidates.length)];
+}

package/lib/types/client/nodes.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Room chat-flow projections: the Definitions claiming the room session's
+ * `room/*` journal events into chat nodes — `room-speech` (a member's
+ * reply), `room-run` (a run's running edge, updated by its terminal edge:
+ * done/cancelled hide in place, failed stays as a dim error row), `room-event`
+ * (boundary lines: member joined/left), and `room-relay` (the member-to-
+ * member notification gate row, folding resolved edges in place). The
+ * auto-seated main agent's member-added is bookkeeping, not a boundary
+ * event, and is not claimed. `room/dispatch` is deliberately NOT claimed:
+ * the human's @-message lands as a standard `user/message` event (see
+ * RoomService.postMessage) and renders through the official user node.
+ * @module @khorsheed/dsh-room/client/nodes
+ */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { ConversationNodeDefinition } from '@deepseek-ai/dsh-client-ui-conversation/client';
+/** Chat node data of one member speech row. */
+export interface RoomSpeechData {
+    /** Partial output from a stopped or failed run; never a completed answer. */
+    readonly interrupted?: 'cancelled' | 'failed';
+    /** Seq of the room/speech event. */
+    readonly seq: number;
+    /** Unix epoch ms from the event. */
+    readonly time: number;
+    readonly member: string;
+    readonly text: string;
+    /** The member's child session (jump target), when recorded. */
+    readonly childSessionId?: SessionId;
+    /** Dispatch→settle milliseconds, when measured. */
+    readonly durationMs?: number;
+}
+/** Chat node data of one member run row. */
+export interface RoomRunData {
+    /** Seq of the running edge's event. */
+    readonly seq: number;
+    /** Unix epoch ms from the running edge's event. */
+    readonly time: number;
+    readonly member: string;
+    readonly startedAt: number;
+    readonly state: 'running' | 'done' | 'cancelled' | 'failed';
+    /** Settled run milliseconds (terminal edges only). */
+    readonly elapsedMs?: number;
+    /** Why the run failed (failed terminal edges only). */
+    readonly error?: string;
+}
+/** Chat node data of one boundary line (member join/leave). */
+export interface RoomEventData {
+    /** Seq of the source event. */
+    readonly seq: number;
+    /** Unix epoch ms from the event. */
+    readonly time: number;
+    readonly sub: 'member-added' | 'member-removed';
+    /** The joining/leaving member. */
+    readonly member?: string;
+    /** The joining member's provider (member-added, cli members). */
+    readonly provider?: string;
+    /** Who invited the joining member (member-added). */
+    readonly invitedBy?: 'human' | 'agent';
+}
+/** Chat node data of one member-to-member notification relay row. */
+export interface RoomRelayData {
+    /** Seq of the relay's latest journal event. */
+    readonly seq: number;
+    /** Unix epoch ms from the relay event. */
+    readonly time: number;
+    /** The relay id (confirm/dismiss key). */
+    readonly relayId: string;
+    readonly from: string;
+    readonly to: string;
+    readonly content: string;
+    readonly state: 'pending' | 'confirmed' | 'dismissed' | 'sent';
+}
+/** Chat node data of one task-advance line (the dim "✓ ada 完成了「…」" row). */
+export interface RoomTaskLineData {
+    /** Seq of the task's LATEST journal event (add or the closing update). */
+    readonly seq: number;
+    /** Unix epoch ms of that event. */
+    readonly time: number;
+    readonly taskId: string;
+    readonly member: string;
+    readonly title: string;
+    readonly status: 'pending' | 'in_progress' | 'done' | 'cancelled' | 'failed';
+}
+declare module '@deepseek-ai/dsh-client-ui-chat/client' {
+    interface ChatNodeDataMap {
+        /** room: a member's reply (identity row + unframed markdown + actions). */
+        'room-speech': RoomSpeechData;
+        /** room: a member run's live row (running; failed stays dim). */
+        'room-run': RoomRunData;
+        /** room: a boundary line (join/leave). */
+        'room-event': RoomEventData;
+        /** room: a member-to-member notification relay (gate row). */
+        'room-relay': RoomRelayData;
+        /** room: a task closure's advance line (visible only once done). */
+        'room-task-line': RoomTaskLineData;
+    }
+}
+/**
+ * The member-speech Definition: one single-event Context per room/speech
+ * event (a CLI member's reply mirrored onto the blackboard).
+ */
+export declare const roomSpeechDefinition: ConversationNodeDefinition<RoomSpeechData>;
+/**
+ * The member-run Definition: one Context per run (matched on
+ * member+startedAt), started by the running edge and updated by its terminal
+ * edge. A running run renders the live row; a failed run stays as a dim
+ * error row; done/cancelled hide the row IN PLACE — the assembler's live
+ * incremental flush forbids withdrawing a materialized node with null (the
+ * withdrawal contract is the same key with `visibility: 'hidden'`; a null
+ * there throws and freezes the session's whole chat pipeline), while the
+ * speech row or the cancel's own affordances carry the outcome.
+ */
+export declare const roomRunDefinition: ConversationNodeDefinition<RoomRunData>;
+/**
+ * The boundary Definition: one single-event Context per member-added (cli
+ * members only — the auto-seated main agent is skipped) or member-removed
+ * event. `room/dispatch` stays unclaimed: the human's @-message renders
+ * through the official user node (it is also appended as `user/message`).
+ */
+export declare const roomEventDefinition: ConversationNodeDefinition<RoomEventData>;
+/**
+ * The relay Definition: one Context per relay (matched on the relay id),
+ * started by the `room/relay` event (pending) and updated by each
+ * `room/relay-resolved` edge — the gate row's state folds in place.
+ */
+export declare const roomRelayDefinition: ConversationNodeDefinition<RoomRelayData>;
+/**
+ * The task-advance Definition: one Context per task (matched on the task id),
+ * started by the `room/task-added` event and updated by each
+ * `room/task-updated` edge. The node stays HIDDEN while the task is open or
+ * cancelled and materializes — at the closing event's seq, so the line sits
+ * at the moment of completion — only when the task closes done: the dim
+ * advance line `✓ ada 完成了「API 定稿」── 目标进度 2/5`. (The goal progress
+ * suffix is computed by the renderer from the room store, not folded here.)
+ */
+export declare const roomTaskLineDefinition: ConversationNodeDefinition<RoomTaskLineData>;
+//# sourceMappingURL=nodes.d.ts.map