@deepseek-harness-tui/dsh-tui 0.8.3 → 0.8.5

package/README.md

@@ -112,17 +112,26 @@ npm install -g @deepseek-harness-tui/dsh-tui@<profile-version>
 
 | 键 | 功能 |
 |---|---|
-| `Enter` | 发送（`Shift+Enter` 换行，无法上报修饰键时可用 `Ctrl+J`）；命令菜单打开时执行选中项 |
+| `Enter` | 空闲=发送（`Shift+Enter` 换行，无法上报修饰键时可用 `Ctrl+J`，mac Terminal.app 可用 `Option+Enter` 兜底，issue #110）；**模型工作时=steer**（注入下一步边界，不中断）；命令菜单打开时执行选中项 |
+| `Ctrl+Enter`（⌘Enter） | **打断当前回合并立即发送**（interrupt） |
+| `Alt+Up` | 把最后一条未处理消息取回输入框编辑（不中断回合） |
+| `Tab` | 补全 `/` 命令或 `@` 文件（目录可继续深入）；**模型工作时=follow-up**（排入当前回合之后） |
 | `Ctrl+C` | 中断当前回合；空闲时连按两次退出 |
 | `Esc` | 关闭命令/文件菜单；空闲双击清空输入；**空输入双击 = 时间回溯** |
 | `Ctrl+O` | 展开/收起详情（思考全文、工具参数与输出） |
 | `Ctrl+R` | 历史消息搜索 |
 | `/` | 会话内全文搜索（`n`/`N` 跳转） |
-| `Tab` / `Enter` | 命令 / `@` 文件补全（目录可继续深入） |
 | `Ctrl+V` | 粘贴文本或文件管理器中的文件；图片显示为 `[Image #N]` 并作为持久附件发送 |
 | `Ctrl+X` | 用 `$VISUAL`/`$EDITOR`（如 nvim）打开当前输入编辑，保存退出后回填 |
-| `?` | 快捷键菜单 |
+| `?` | 快捷键菜单（仅输入框为空时响应） |
 | `Shift+↑` | 消息选择模式（Enter 展开单条） |
+| `Ctrl+P` | 切换启动时 loaded-context 面板（面板在屏时有效） |
+| `Home` / `End`、`Ctrl+A` / `Ctrl+E` | 逻辑行首 / 行尾；`Ctrl+E` 双义：输入框=行尾，转录中=展开/折叠隐藏的旧消息 |
+| `Ctrl+←` / `Ctrl+→`（⌘←/→） | 按词跳转 |
+| `Ctrl+U` / `Ctrl+K` | 删除光标前（至行首）/ 光标后（至行尾） |
+| `Ctrl+W` | 删除前一个单词 |
+
+**模型工作中的三态投递**：`Enter`=steer（注入下一步边界，不中断）· `Tab`=follow-up（排入当前回合之后）· `Ctrl+Enter`=interrupt（打断并立即发送）。
 
 **macOS 修饰键**：上表中 Windows/Linux 的 `Ctrl+<键>` 在 macOS 上同时可用 `⌘<键>`
 （如 `⌘V` 粘贴、`⌘O` 展开详情、`⌘Enter` 立即发送）；仅 `Ctrl+C` / `Ctrl+D`
@@ -136,8 +145,13 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 |---|---|
 | 拖拽选择 | 应用内文本选区，**松开即复制**（OSC 52 + `wl-copy`/`xclip`/`xsel` 原生兜底；tmux 内走 `load-buffer -w`），复制后自动取消选区并弹出「已复制 N 个字符」提示 |
 | 双击 / 三击 | 选词 / 选行，同样即选即复制 |
-| 滚轮 | 滚动消息列表 |
+| 滚轮 | 滚动消息列表（±3 行/格） |
 | `Esc` | 拖拽进行中取消选区（不复制） |
+| 单击消息行 | 展开/收起该行 |
+| 单击「加载更早消息」/「ctrl+e 显示前 N 条」 | 加载更早消息 / 展开全部 |
+| 单击 StickyHeader / 「↓ N new messages」 | 跳回固定消息处 / 滚动到底部 |
+| 单击超链接 | 打开浏览器 |
+| 键盘扩展选区 | 有选区时 `Shift+←/→/↑/↓/Home/End` 扩展/收缩（跨行环绕） |
 
 **问卷（模型发起 `ask_user_question` 时）**
 
@@ -147,19 +161,21 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 | `Space` | 多选题勾选/取消 |
 | `Tab` | 切到自定义回答（不选选项直接打字） |
 | `Enter` | 提交当前选择 |
-| `Esc` | 中断提问（模型收到 ASK_ABORTED，可继续对话） |
+| `Esc` / `Ctrl+C` | 取消整批提问（模型收到 ASK_CANCELLED，可继续对话） |
 
 **本地命令（CC 指令全集复刻，均走 DSH 官方链路）**
 
 | 分组 | 命令 |
 |---|---|
-| 会话 | `/new` 新会话 · `/resume` 会话浏览器（搜索、预览、跨项目、折叠子 agent 运行） · `/rename` 重命名会话 · `/workspace resume|rename|open` 管理工作区 · `/clear` 清屏 · `/compact` 压缩 · `/export` 导出 Markdown · `/trace` 轨迹场景（亦可 `Ctrl+T`） |
-| 状态 | `/context` 已加载上下文明细 · `/status` 会话信息 · `/cost` token 用量 · `/doctor` 环境自检 · `/config` 配置来源 · `/init` 创建 AGENTS.md |
-| 模型 | `/model` 选择器 · `/thinking` 思考显示 · `/tokens` token 明细 · `/theme` 主题选择器 · `/lang` 中英界面切换（`/settings` 中亦可选择） |
+| 会话 | `/new` 新会话 · `/resume` 会话浏览器（搜索、预览、跨项目、折叠子 agent 运行） · `/rename` 重命名会话 · `/workspace resume|rename|open` 管理工作区 · `/clear` 清屏 · `/compact` 压缩 · `/export` 导出 Markdown · `/trace` 轨迹场景（亦可 `Ctrl+T`） · `/rewind` 回退选择器（同空输入双击 Esc 的时间回溯） · `/btw <问题>` 侧问（不打断主回合、不写历史） |
+| 状态 | `/context` 已加载上下文明细 · `/status` 会话信息 · `/cost` token 用量 · `/doctor` 环境自检 · `/config` 配置来源 · `/init` 创建 AGENTS.md · `/settings` 设置面板（命名空间读取/编辑） |
+| 模型 | `/model` 选择器（**切换 = fork 会话续聊，历史保留**） · `/effort` 推理强度（滑杆 / `status` / `<id>`） · `/preset` Agent 预设（**已开始会话不可切换**，blank-only） · `/thinking` 思考显示 · `/tokens` token 明细 · `/activity` 工作状态行动画（`frames <名>` / `status`） · `/theme` 主题选择器 · `/lang` 中英界面切换（`/settings` 中亦可选择） |
 | 账号/策略 | `/provider` 添加模型提供方 · `/login` 凭证状态 · `/logout` 登出说明 · `/permissions` 权限说明 · `/add-dir` 文件策略范围 · `/hooks` · `/mcp` |
 | 技能 | `/audit` 代码审计 · `/bug` bug 报告 · `/review` 代码评审 · `/practice` 编程练习 · `/pr_comments` PR 评论 · `/release-notes` 发布说明 · `/vuln-check` 漏洞检查 |
-| 其它 | `/agents` 子代理列表 · `/update` 自动更新并重启 · `/vim` · `/terminal-setup` · `/connect` · `/help` · `/exit` |
-| 注册表 | `/plan` `/goal`（DSH 命令注册表插件，随插件自动并入 `/` 菜单） |
+| 其它 | `/agents` 子代理列表 · `/skills` 技能目录 · `/plugins check <路径>` 插件诊断 · `/update` 自动更新并重启 · `/vim` · `/terminal-setup` · `/connect` · `/help` · `/exit`（别名 `/quit` `/q`） |
+| 注册表 | `/plan` `/goal` `/feedback` `/permission`（DSH 命令注册表插件，随插件自动并入 `/` 菜单） |
+
+> 未知命令会作为普通消息发给模型（如 `/permission` 未挂载的组合里）。
 
 ## 插件生态
 
@@ -265,6 +281,9 @@ compaction 和持久化继续由 DSH 服务拥有。更详细的模块边界与
   未挂载该插件（无 `/permission` 命令）。
 - `/vim` `/connect` `/hooks` 为 CC 同名占位：对应能力在 DSH 侧无等价
   机制，命令会给出明确说明而非静默。
+- `/thinking` 思考显示开关**不持久化**，重启或新会话回到默认。
+- minimal preset 下 `/compact` 不可用（minimal 不组合 compaction）。
+- `/update` 仅 `dsh --profile` 启动方式可用，回合运行中会拒绝。
 
 完整已知限制与安全边界见[架构与限制](docs/architecture.md)。
 

package/bin/dsh-tui.js

@@ -64,6 +64,24 @@ const MSG = {
     en: `[dsh-tui] Plugin install failed. Retry manually later:\n  dsh plugin --profile ${PROFILE} add -w ${PACKAGE}@${ownVersion}`,
     zh: `[dsh-tui] 插件安装失败。可稍后手工重试：\n  dsh plugin --profile ${PROFILE} add -w ${PACKAGE}@${ownVersion}`,
   },
+  // no-op 假成功（自举后复查发现判定文件依旧缺失）：pnpm 把包文件残缺的
+  // profile 视为 already up to date，重装什么都不做却报告成功；继续启动
+  // 只会以 cannot resolve profile bundle 崩溃，而崩溃提示的 `plugin
+  // install` 同样 no-op——用户会陷入「每步都成功、每次都崩」的循环。
+  bootstrapUnreadable: {
+    en: dir =>
+      `[dsh-tui] install reported success but the plugin package is still unreadable under:\n` +
+      `  ${dir}\n` +
+      `  pnpm treats this half-installed profile as already up to date, so every retry\n` +
+      `  reports success while boot keeps failing. Recovery:\n` +
+      `  rm -rf ${dir} && dsh-tui`,
+    zh: dir =>
+      `[dsh-tui] 安装报告成功，但插件包仍不可读：\n` +
+      `  ${dir}\n` +
+      `  pnpm 把半残的 profile 视为已装好，重试永远「成功」而启动照旧崩溃。\n` +
+      `  恢复方法：\n` +
+      `  rm -rf ${dir} 后重新运行 dsh-tui`,
+  },
   // Non-fatal skew comes in two directions and each needs its own repair:
   // a profile NEWER than the launcher (typical after /update) must point at
   // the global install, while a profile older only in patch must point back
@@ -158,11 +176,12 @@ const dshHome = process.env.DSH_HOME || join(homedir(), '.dsh')
 const profileDir = join(dshHome, 'profiles', PROFILE)
 // 以已装包的 package.json 可读为准（而非目录存在）：安装中途失败留下的
 // 残骸目录会触发重新安装，而不是以坏 profile 直接启动。
+// 包可读判定文件：installedVersion 读取与自举后的复查共用（残缺 profile
+// 的 no-op 假成功靠它识别——见 bootstrapUnreadable）。
+const installedPkgPath = join(profileDir, 'node_modules', '@deepseek-harness-tui', 'dsh-tui', 'package.json')
 let installedVersion
 try {
-  installedVersion = JSON.parse(
-    readFileSync(join(profileDir, 'node_modules', '@deepseek-harness-tui', 'dsh-tui', 'package.json'), 'utf8'),
-  ).version
+  installedVersion = JSON.parse(readFileSync(installedPkgPath, 'utf8')).version
 } catch {
   installedVersion = undefined
 }
@@ -175,21 +194,41 @@ if (installedVersion === undefined) {
   console.log(msg('bootstrapStart'))
   // pnpm ≥11 在带 pnpm-workspace.yaml 的 profile 目录里可能拒绝向
   // workspace root 写依赖（ERR_PNPM_ADDING_TO_ROOT，issue #239）：识别该
-  // 错误时带 -w 重试一次。stderr 走 pipe 捕获供识别，stdout 保持
-  // inherit 让用户实时看到安装进度；手工重试提示同步带 -w。
-  const runAdd = extraArgs => spawnSync(
+  // 错误时带 -w 重试一次。签名在 stdout——pnpm 的错误报告写 stdout（经
+  // dsh 原样转发），stderr 上只有 dsh 自己的失败说明，识别 stderr 永远
+  // 匹配不到（PR #241 的回归）。因此首次 add 的 stdout/stderr 都走 pipe
+  // 捕获，结束后回放（失败回 stderr 保诊断，成功回 stdout 保进度，代价
+  // 是不再实时）；-w 重试大概率成功，恢复 inherit 让进度实时可见。手工
+  // 重试提示同步带 -w。
+  const runAdd = (extraArgs, capture) => spawnSync(
     ...cmd('dsh', ['plugin', '--profile', PROFILE, 'add', ...extraArgs, `${PACKAGE}@${ownVersion}`]),
-    { stdio: ['inherit', 'inherit', 'pipe'], ...shellOpt },
+    { stdio: capture ? ['inherit', 'pipe', 'pipe'] : 'inherit', ...shellOpt },
   )
-  let add = runAdd([])
-  if (add.status !== 0 && String(add.stderr).includes('ERR_PNPM_ADDING_TO_ROOT')) {
-    console.log(msg('bootstrapRetryW'))
-    add = runAdd(['-w'])
+  let add = runAdd([], true)
+  if (add.status !== 0) {
+    const captured = `${add.stdout ?? ''}${add.stderr ?? ''}`
+    process.stderr.write(captured)
+    if (captured.includes('ERR_PNPM_ADDING_TO_ROOT')) {
+      console.log(msg('bootstrapRetryW'))
+      add = runAdd(['-w'], false)
+    }
+  } else {
+    process.stdout.write(`${add.stdout ?? ''}${add.stderr ?? ''}`)
   }
   if (add.status !== 0) {
     console.error(msg('installFailed'))
     process.exit(add.status ?? 1)
   }
+  // 自举后复查：pnpm 对包文件残缺的 profile 视为 already up to date，
+  // add 报告成功却什么都没装（no-op 假成功）。此时继续启动只会以 cannot
+  // resolve profile bundle 崩溃，提示的 `plugin install` 又同样 no-op——
+  // fail loud 给出唯一可靠的恢复路径（删 profile 目录重建）。
+  try {
+    readFileSync(installedPkgPath, 'utf8')
+  } catch {
+    console.error(MSG.bootstrapUnreadable[lang](profileDir))
+    process.exit(1)
+  }
 } else if (installedVersion !== ownVersion) {
   // Reverse skew is fatal (see MSG.profileOlderThanLauncher): compare
   // major/minor only — patch-level differences never move the patch surface.

package/dsh-ecosystem-spec/protocols/profile-definitions.d.ts

@@ -1,13 +1,13 @@
-import type { ApiReference, ProtocolCatalog, ProtocolDefinition } from '@dsh-std/core'
-export { registerTuiContributionExtensions } from './tui-contributions.js'
-export * from './tui-channel.js'
-
-export const DECISION_EVENTS: Readonly<ApiReference & {
-  apiVersion: 'tui.dsh/v1alpha1'
-  kind: 'DecisionEvents'
-}>
-
-export const decisionEventsDefinition: ProtocolDefinition
-export const profileDefinitions: readonly ProtocolDefinition[]
-
-export function registerProfileProtocols(catalog: ProtocolCatalog): () => void
+import type { ApiReference, ProtocolCatalog, ProtocolDefinition } from '@dsh-std/core'
+export { registerTuiContributionExtensions } from './tui-contributions.js'
+export * from './tui-channel.js'
+
+export const DECISION_EVENTS: Readonly<ApiReference & {
+  apiVersion: 'tui.dsh/v1alpha1'
+  kind: 'DecisionEvents'
+}>
+
+export const decisionEventsDefinition: ProtocolDefinition
+export const profileDefinitions: readonly ProtocolDefinition[]
+
+export function registerProfileProtocols(catalog: ProtocolCatalog): () => void

package/dsh-ecosystem-spec/protocols/profile-definitions.js

@@ -1,59 +1,59 @@
-/** dsh-TUI private protocol definitions evaluated by @dsh-std/core. */
-
-export { registerTuiContributionExtensions } from './tui-contributions.js'
-export * from './tui-channel.js'
-import { tuiChannelDefinition } from './tui-channel.js'
-
-export const DECISION_EVENTS = Object.freeze({
-  apiVersion: 'tui.dsh/v1alpha1',
-  kind: 'DecisionEvents',
-})
-
-function featureSupport(value, label) {
-  if (value === undefined) return Object.freeze({ features: Object.freeze([]) })
-  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
-    throw new TypeError(`${label} support spec must be an object`)
-  }
-  const unknown = Object.keys(value).filter(key => key !== 'features' && !key.startsWith('x-'))
-  if (unknown.length > 0) throw new TypeError(`${label} support spec contains unknown field ${JSON.stringify(unknown[0])}`)
-  if (value.features !== undefined && (!Array.isArray(value.features)
-    || value.features.some(feature => typeof feature !== 'string' || feature.trim() === ''))) {
-    throw new TypeError(`${label} support spec.features must be an array of non-empty strings`)
-  }
-  return Object.freeze({ features: Object.freeze([...(value.features ?? [])].sort()) })
-}
-
-function providerDefinition(reference, label) {
-  return Object.freeze({
-    ...reference,
-    validateRequirement(value) {
-      if (value !== undefined) throw new TypeError(`${label} requirement does not accept spec in manifest v0.15`)
-      return undefined
-    },
-    validateSupport(value) { return featureSupport(value, label) },
-    negotiate(input) {
-      const providers = [...new Set(input.supports.map(row => row.participant))].sort()
-      const issues = input.requirements.flatMap(row => providers.length === 0
-        ? [{
-            code: row.requirement.optional === true ? 'optional-support-missing' : 'required-support-missing',
-            severity: row.requirement.optional === true ? 'warning' : 'error',
-            participant: row.participant,
-            message: `${label} has no provider in this negotiation scope`,
-          }]
-        : [])
-      return { agreement: Object.freeze({ providers: Object.freeze(providers) }), issues: Object.freeze(issues) }
-    },
-  })
-}
-
-export const decisionEventsDefinition = providerDefinition(DECISION_EVENTS, 'DecisionEvents')
-
-export const profileDefinitions = Object.freeze([
-  decisionEventsDefinition,
-  tuiChannelDefinition,
-])
-
-export function registerProfileProtocols(catalog) {
-  const disposers = profileDefinitions.map(definition => catalog.register(definition))
-  return () => { for (const dispose of disposers.reverse()) dispose() }
-}
+/** dsh-TUI private protocol definitions evaluated by @dsh-std/core. */
+
+export { registerTuiContributionExtensions } from './tui-contributions.js'
+export * from './tui-channel.js'
+import { tuiChannelDefinition } from './tui-channel.js'
+
+export const DECISION_EVENTS = Object.freeze({
+  apiVersion: 'tui.dsh/v1alpha1',
+  kind: 'DecisionEvents',
+})
+
+function featureSupport(value, label) {
+  if (value === undefined) return Object.freeze({ features: Object.freeze([]) })
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    throw new TypeError(`${label} support spec must be an object`)
+  }
+  const unknown = Object.keys(value).filter(key => key !== 'features' && !key.startsWith('x-'))
+  if (unknown.length > 0) throw new TypeError(`${label} support spec contains unknown field ${JSON.stringify(unknown[0])}`)
+  if (value.features !== undefined && (!Array.isArray(value.features)
+    || value.features.some(feature => typeof feature !== 'string' || feature.trim() === ''))) {
+    throw new TypeError(`${label} support spec.features must be an array of non-empty strings`)
+  }
+  return Object.freeze({ features: Object.freeze([...(value.features ?? [])].sort()) })
+}
+
+function providerDefinition(reference, label) {
+  return Object.freeze({
+    ...reference,
+    validateRequirement(value) {
+      if (value !== undefined) throw new TypeError(`${label} requirement does not accept spec in manifest v0.15`)
+      return undefined
+    },
+    validateSupport(value) { return featureSupport(value, label) },
+    negotiate(input) {
+      const providers = [...new Set(input.supports.map(row => row.participant))].sort()
+      const issues = input.requirements.flatMap(row => providers.length === 0
+        ? [{
+            code: row.requirement.optional === true ? 'optional-support-missing' : 'required-support-missing',
+            severity: row.requirement.optional === true ? 'warning' : 'error',
+            participant: row.participant,
+            message: `${label} has no provider in this negotiation scope`,
+          }]
+        : [])
+      return { agreement: Object.freeze({ providers: Object.freeze(providers) }), issues: Object.freeze(issues) }
+    },
+  })
+}
+
+export const decisionEventsDefinition = providerDefinition(DECISION_EVENTS, 'DecisionEvents')
+
+export const profileDefinitions = Object.freeze([
+  decisionEventsDefinition,
+  tuiChannelDefinition,
+])
+
+export function registerProfileProtocols(catalog) {
+  const disposers = profileDefinitions.map(definition => catalog.register(definition))
+  return () => { for (const dispose of disposers.reverse()) dispose() }
+}

package/dsh-ecosystem-spec/protocols/tui-channel-http.d.ts

@@ -1,15 +1,15 @@
-export const TUI_CHANNEL_HTTP_API_VERSION: 'tui.dsh/v1alpha1'
-export const TUI_CHANNEL_HTTP_KIND: 'ChannelEndpoint'
-export const TUI_CHANNEL_HTTP_HEALTH_PATH: '/dsh-tui/v1/health'
-export const TUI_CHANNEL_HTTP_DESCRIPTOR_PATH: '/dsh-tui/v1/endpoint'
-export const TUI_CHANNEL_HTTP_WEBSOCKET_PATH: '/dsh-tui/v1/connection'
-
-export interface TuiChannelEndpointDescriptor {
-  readonly apiVersion: typeof TUI_CHANNEL_HTTP_API_VERSION
-  readonly kind: typeof TUI_CHANNEL_HTTP_KIND
-  readonly origin: string
-  readonly connection: typeof TUI_CHANNEL_HTTP_WEBSOCKET_PATH
-}
-
-export function createTuiChannelEndpointDescriptor(origin: string): TuiChannelEndpointDescriptor
-export function validateTuiChannelEndpointDescriptor(value: unknown): TuiChannelEndpointDescriptor
+export const TUI_CHANNEL_HTTP_API_VERSION: 'tui.dsh/v1alpha1'
+export const TUI_CHANNEL_HTTP_KIND: 'ChannelEndpoint'
+export const TUI_CHANNEL_HTTP_HEALTH_PATH: '/dsh-tui/v1/health'
+export const TUI_CHANNEL_HTTP_DESCRIPTOR_PATH: '/dsh-tui/v1/endpoint'
+export const TUI_CHANNEL_HTTP_WEBSOCKET_PATH: '/dsh-tui/v1/connection'
+
+export interface TuiChannelEndpointDescriptor {
+  readonly apiVersion: typeof TUI_CHANNEL_HTTP_API_VERSION
+  readonly kind: typeof TUI_CHANNEL_HTTP_KIND
+  readonly origin: string
+  readonly connection: typeof TUI_CHANNEL_HTTP_WEBSOCKET_PATH
+}
+
+export function createTuiChannelEndpointDescriptor(origin: string): TuiChannelEndpointDescriptor
+export function validateTuiChannelEndpointDescriptor(value: unknown): TuiChannelEndpointDescriptor

package/dsh-ecosystem-spec/protocols/tui-channel-http.js

@@ -1,32 +1,32 @@
-export const TUI_CHANNEL_HTTP_API_VERSION = 'tui.dsh/v1alpha1'
-export const TUI_CHANNEL_HTTP_KIND = 'ChannelEndpoint'
-export const TUI_CHANNEL_HTTP_HEALTH_PATH = '/dsh-tui/v1/health'
-export const TUI_CHANNEL_HTTP_DESCRIPTOR_PATH = '/dsh-tui/v1/endpoint'
-export const TUI_CHANNEL_HTTP_WEBSOCKET_PATH = '/dsh-tui/v1/connection'
-
-export function createTuiChannelEndpointDescriptor(origin) {
-  const normalized = new URL(origin)
-  if (normalized.protocol !== 'http:' && normalized.protocol !== 'https:') {
-    throw new TypeError('TUI Channel endpoint origin must use http or https')
-  }
-  normalized.pathname = '/'
-  normalized.search = ''
-  normalized.hash = ''
-  return Object.freeze({
-    apiVersion: TUI_CHANNEL_HTTP_API_VERSION,
-    kind: TUI_CHANNEL_HTTP_KIND,
-    origin: normalized.toString().replace(/\/$/u, ''),
-    connection: TUI_CHANNEL_HTTP_WEBSOCKET_PATH,
-  })
-}
-
-export function validateTuiChannelEndpointDescriptor(value) {
-  if (typeof value !== 'object' || value === null || Array.isArray(value)) throw new TypeError('TUI Channel endpoint descriptor must be an object')
-  if (value.apiVersion !== TUI_CHANNEL_HTTP_API_VERSION || value.kind !== TUI_CHANNEL_HTTP_KIND) {
-    throw new TypeError('TUI Channel endpoint descriptor version or kind is unsupported')
-  }
-  if (typeof value.origin !== 'string') throw new TypeError('TUI Channel endpoint origin must be a string')
-  createTuiChannelEndpointDescriptor(value.origin)
-  if (value.connection !== TUI_CHANNEL_HTTP_WEBSOCKET_PATH) throw new TypeError('TUI Channel endpoint connection path is unsupported')
-  return value
-}
+export const TUI_CHANNEL_HTTP_API_VERSION = 'tui.dsh/v1alpha1'
+export const TUI_CHANNEL_HTTP_KIND = 'ChannelEndpoint'
+export const TUI_CHANNEL_HTTP_HEALTH_PATH = '/dsh-tui/v1/health'
+export const TUI_CHANNEL_HTTP_DESCRIPTOR_PATH = '/dsh-tui/v1/endpoint'
+export const TUI_CHANNEL_HTTP_WEBSOCKET_PATH = '/dsh-tui/v1/connection'
+
+export function createTuiChannelEndpointDescriptor(origin) {
+  const normalized = new URL(origin)
+  if (normalized.protocol !== 'http:' && normalized.protocol !== 'https:') {
+    throw new TypeError('TUI Channel endpoint origin must use http or https')
+  }
+  normalized.pathname = '/'
+  normalized.search = ''
+  normalized.hash = ''
+  return Object.freeze({
+    apiVersion: TUI_CHANNEL_HTTP_API_VERSION,
+    kind: TUI_CHANNEL_HTTP_KIND,
+    origin: normalized.toString().replace(/\/$/u, ''),
+    connection: TUI_CHANNEL_HTTP_WEBSOCKET_PATH,
+  })
+}
+
+export function validateTuiChannelEndpointDescriptor(value) {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) throw new TypeError('TUI Channel endpoint descriptor must be an object')
+  if (value.apiVersion !== TUI_CHANNEL_HTTP_API_VERSION || value.kind !== TUI_CHANNEL_HTTP_KIND) {
+    throw new TypeError('TUI Channel endpoint descriptor version or kind is unsupported')
+  }
+  if (typeof value.origin !== 'string') throw new TypeError('TUI Channel endpoint origin must be a string')
+  createTuiChannelEndpointDescriptor(value.origin)
+  if (value.connection !== TUI_CHANNEL_HTTP_WEBSOCKET_PATH) throw new TypeError('TUI Channel endpoint connection path is unsupported')
+  return value
+}

package/dsh-ecosystem-spec/protocols/tui-channel.d.ts

@@ -1,59 +1,59 @@
-import type { ApiReference, ProtocolDefinition } from '@dsh-std/core'
-
-export type JsonValue = null | boolean | number | string | readonly JsonValue[] | { readonly [key: string]: JsonValue }
-
-export const TUI_CHANNEL: Readonly<ApiReference & {
-  apiVersion: 'tui.dsh/v1alpha1'
-  kind: 'Channel'
-}>
-export const TUI_CHANNEL_WIRE_REVISION: 6
-export const TUI_CHANNEL_FEATURES: readonly string[]
-
-export interface TuiChannelRequirementSpec {
-  readonly wireRevision: number
-  readonly features: readonly string[]
-}
-export interface TuiChannelSupportSpec extends TuiChannelRequirementSpec {}
-
-export interface TuiChannelSnapshot {
-  readonly wireRevision: number
-  readonly channelId: string
-  readonly version: number
-  readonly state: Readonly<Record<string, JsonValue>>
-}
-
-export interface TuiChannelWorkspaceFlowChoice {
-  readonly id: string
-  readonly label: string
-  readonly description?: string
-  readonly badge?: string
-  readonly action: string
-  readonly input?: {
-    readonly action: string
-    readonly initialValue?: string
-    readonly placeholder?: string
-  }
-}
-
-export type TuiChannelWorkspaceFlowResult =
-  | { readonly kind: 'target'; readonly target: import('./tui-contributions.js').WorkspaceTarget }
-  | { readonly kind: 'choices'; readonly title: string; readonly choices: readonly TuiChannelWorkspaceFlowChoice[] }
-
-export type TuiChannelInput =
-  | { readonly operation: 'open'; readonly value: { readonly workspace?: string; readonly sessionId?: string; readonly options?: JsonValue } }
-  | { readonly operation: 'subscribe'; readonly value: { readonly channelId: string; readonly afterVersion: number } }
-  | { readonly operation: 'invoke'; readonly value: { readonly channelId: string; readonly method: string; readonly arguments: readonly JsonValue[] } }
-  | { readonly operation: 'close'; readonly value: { readonly channelId: string } }
-
-export interface TuiChannelInvokeOutput {
-  readonly value: JsonValue
-  readonly valueDefined?: boolean
-  readonly snapshot?: TuiChannelSnapshot
-}
-
-export const tuiChannelDefinition: ProtocolDefinition
-export function validateTuiChannelRequirement(value: unknown): TuiChannelRequirementSpec
-export function validateTuiChannelSupport(value: unknown): TuiChannelSupportSpec
-export function validateTuiChannelInput(operation: string, value: unknown): object
-export function validateTuiChannelSnapshot(value: unknown): TuiChannelSnapshot
-export function validateTuiChannelOutput(operation: string, value: unknown): object
+import type { ApiReference, ProtocolDefinition } from '@dsh-std/core'
+
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | { readonly [key: string]: JsonValue }
+
+export const TUI_CHANNEL: Readonly<ApiReference & {
+  apiVersion: 'tui.dsh/v1alpha1'
+  kind: 'Channel'
+}>
+export const TUI_CHANNEL_WIRE_REVISION: 6
+export const TUI_CHANNEL_FEATURES: readonly string[]
+
+export interface TuiChannelRequirementSpec {
+  readonly wireRevision: number
+  readonly features: readonly string[]
+}
+export interface TuiChannelSupportSpec extends TuiChannelRequirementSpec {}
+
+export interface TuiChannelSnapshot {
+  readonly wireRevision: number
+  readonly channelId: string
+  readonly version: number
+  readonly state: Readonly<Record<string, JsonValue>>
+}
+
+export interface TuiChannelWorkspaceFlowChoice {
+  readonly id: string
+  readonly label: string
+  readonly description?: string
+  readonly badge?: string
+  readonly action: string
+  readonly input?: {
+    readonly action: string
+    readonly initialValue?: string
+    readonly placeholder?: string
+  }
+}
+
+export type TuiChannelWorkspaceFlowResult =
+  | { readonly kind: 'target'; readonly target: import('./tui-contributions.js').WorkspaceTarget }
+  | { readonly kind: 'choices'; readonly title: string; readonly choices: readonly TuiChannelWorkspaceFlowChoice[] }
+
+export type TuiChannelInput =
+  | { readonly operation: 'open'; readonly value: { readonly workspace?: string; readonly sessionId?: string; readonly options?: JsonValue } }
+  | { readonly operation: 'subscribe'; readonly value: { readonly channelId: string; readonly afterVersion: number } }
+  | { readonly operation: 'invoke'; readonly value: { readonly channelId: string; readonly method: string; readonly arguments: readonly JsonValue[] } }
+  | { readonly operation: 'close'; readonly value: { readonly channelId: string } }
+
+export interface TuiChannelInvokeOutput {
+  readonly value: JsonValue
+  readonly valueDefined?: boolean
+  readonly snapshot?: TuiChannelSnapshot
+}
+
+export const tuiChannelDefinition: ProtocolDefinition
+export function validateTuiChannelRequirement(value: unknown): TuiChannelRequirementSpec
+export function validateTuiChannelSupport(value: unknown): TuiChannelSupportSpec
+export function validateTuiChannelInput(operation: string, value: unknown): object
+export function validateTuiChannelSnapshot(value: unknown): TuiChannelSnapshot
+export function validateTuiChannelOutput(operation: string, value: unknown): object