From 45868b940f6f0739a234dcfb5b87a6658d83e90f Mon Sep 17 00:00:00 2001 From: Turtle Date: Wed, 22 Jul 2026 10:55:17 +0800 Subject: [PATCH] =?UTF-8?q?feat(tui):=20startup=20banner=20iterations=20?= =?UTF-8?q?=E2=80=94=20slogans,=20sweep=20reveal,=20then=20no=20banner?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Squashes three linearized steps (feat/tui-startup, feat/banner-reveal, feat/remove-banner): the banner experiment converged on removing the startup banner entirely; later commits restore it borderless and add the brand gradient. --- .../2026-07-20-tui-startup-slogans.i18n.yaml | 6 + .../feature/2026-07-20-tui-startup-slogans.md | 39 ++++++ .../2026-07-20-tui-startup-slogans.zh.md | 39 ++++++ .../2026-07-21-tui-banner-sweep.i18n.yaml | 6 + .../feature/2026-07-21-tui-banner-sweep.md | 35 +++++ .../feature/2026-07-21-tui-banner-sweep.zh.md | 35 +++++ .../2026-07-21-tui-no-banner.i18n.yaml | 6 + .../feature/2026-07-21-tui-no-banner.md | 37 +++++ .../feature/2026-07-21-tui-no-banner.zh.md | 37 +++++ .../bash-terminal-card/terminal.expected.txt | 86 ++++++------ .../snapshots/code-mode/terminal.expected.txt | 90 ++++++------ .../terminal.expected.txt | 126 ++++++++--------- .../dynamic-workflow/terminal.expected.txt | 120 ++++++++-------- .../terminal.expected.txt | 88 ++++++------ .../parallel-file-reads/terminal.expected.txt | 104 +++++++------- .../snapshots/todo-plan/terminal.expected.txt | 97 ++++++------- packages/ui/tui/tests/harness.ts | 4 +- .../advanced-cards-collapsed.expected.txt | 114 +++++++--------- .../advanced-cards-expanded.expected.txt | 124 ++++++++--------- .../snapshots/code-mode-pending.expected.txt | 60 ++++---- .../conversation-streaming.expected.txt | 68 ++++----- .../cordis-tools-pending.expected.txt | 66 ++++----- .../snapshots/disposed-terminal.expected.txt | 85 +++++------- .../dynamic-workflow-pending.expected.txt | 65 ++++----- .../snapshots/errors-and-help.expected.txt | 85 +++++------- .../question-dialog-validation.expected.txt | 100 ++++++++------ .../snapshots/question-dialog.expected.txt | 91 ++++++------ ...rface-after-compaction-narrow.expected.txt | 48 +++---- ...surface-after-compaction-wide.expected.txt | 48 +++---- .../surface-before-compaction.expected.txt | 76 +++++------ .../snapshots/untrusted-controls.expected.txt | 129 ++++++++++-------- 31 files changed, 1092 insertions(+), 1022 deletions(-) create mode 100644 .agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.i18n.yaml create mode 100644 .agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.md create mode 100644 .agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.zh.md create mode 100644 .agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.i18n.yaml create mode 100644 .agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.md create mode 100644 .agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.zh.md create mode 100644 .agents/notes/implemented/feature/2026-07-21-tui-no-banner.i18n.yaml create mode 100644 .agents/notes/implemented/feature/2026-07-21-tui-no-banner.md create mode 100644 .agents/notes/implemented/feature/2026-07-21-tui-no-banner.zh.md diff --git a/.agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.i18n.yaml b/.agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.i18n.yaml new file mode 100644 index 0000000000..3ed957d231 --- /dev/null +++ b/.agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.i18n.yaml @@ -0,0 +1,6 @@ +# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each +# side as of the last confirmed-consistent state. Both languages carry equal authority; +# after editing either side, bring the other along and re-record with: +# pnpm run verify-translation-pairing --write +2026-07-20-tui-startup-slogans.md: a2a22baafddd08145cec0d03b65ee56b2f8114b1 +2026-07-20-tui-startup-slogans.zh.md: 58fa5790f315845f27b810d62658bd79428b519b diff --git a/.agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.md b/.agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.md new file mode 100644 index 0000000000..a2a22baafd --- /dev/null +++ b/.agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.md @@ -0,0 +1,39 @@ +# Agent Note: Startup slogans replace the configured TUI welcome line + +Status: implemented + +English | [中文](2026-07-20-tui-startup-slogans.zh.md) + +> **Superseded** for the slogan/animation half by the [banner sweep Agent Note](2026-07-21-tui-banner-sweep.md): the slogan bank and typewriter reveal shipped, read as weird in use, and were replaced by a subtitle-free banner with a whole-banner sweep. The removal of the configured demo welcome and the animation-lifecycle groundwork (start after `ui.start()`, clear through `detachListeners`) stand. + +## Problem + +The TUI header subtitle came from a `welcome` config the demo leaf set to "TUI agent ready. Give it a coding task." — instructional filler that told a returning user nothing, restated what the product is on every boot, and had a hardcoded twin (`'ready.'`) as the schema default in two packages. The product wanted a startup moment with some character instead of a static banner caption. + +## Decision + +- `examples/tui-agent/cordis.yml` no longer configures `welcome`; the config key stays for deployments and fixtures that need a fixed, deterministic subtitle (the Code Mode overlay and every snapshot/scripted fixture keep theirs). +- When `welcome` is unset, `dsh-tui` picks one member of an exported `STARTUP_SLOGANS` bank per boot (`pickStartupSlogan`, injectable random source) and reveals it with a typewriter animation: one character per 40 ms frame, a `▌` block cursor trailing until complete. The reveal starts only after `ui.start()` succeeds and its interval is cleared on dispose alongside the other listeners. +- The slogan bank is presentation copy, deliberately not config: deployments that want controlled wording already have `welcome`. Slogans are ASCII-only by contract because the reveal slices per character. +- `dsh-tui-demo` forwards `welcome` only when configured instead of defaulting it, so the app no longer decides the TUI's idle subtitle. +- The keyless PTY boot scenario now waits for the reveal cursor (`▌` — the only source of that glyph in an empty transcript) instead of the removed welcome text. + +The same change restores `packages/ui/tui/src/index.ts` to 100 % per-file coverage, which the color-scheme merge had broken on the integration branch: the editor border-color reassignment inside `applyColorScheme` was dead (the `setStatus` call right after re-derives it) and is removed, and the color-scheme query's `.then`/`.catch` arrows became named, tested handlers (`applyReportedScheme`, `ignoreSchemeQueryFailure` — the latter pinned by a test whose terminal throws on the DSR query write). + +## Alternatives considered + +**A fixed cooler slogan.** Rejected: one string re-read on every boot decays into wallpaper exactly like the line it replaces; a small rotating bank keeps the moment alive at no complexity cost. + +**Making the bank and reveal speed configurable.** Rejected: that is two new knobs for presentation copy; `welcome` is already the escape hatch for deployments with an opinion, and the no-hardcoded-tunables rule targets deployment-varying behavior, not brand copy. + +**Animating in `HeaderComponent` itself.** Rejected: the component would need a TUI handle and its own lifecycle; the chat already owns a render loop, timers, and a disposal path, so the reveal lives beside the other `createTuiChat` effects and `detachListeners` clears it. + +## Consequences + +- Boot output is no longer byte-deterministic when `welcome` is unset (random slogan, timed frames). Every recorded or snapshot surface pins `welcome` explicitly, so no snapshot changed; the PTY smoke anchors on the reveal cursor and the session-id line instead. +- The `welcome` schema default disappeared from both `dsh-tui` and `dsh-tui-demo`; a direct caller passing no welcome now gets a slogan, not `'ready.'`. +- Adding a slogan is a one-line bank edit; tests assert membership, not specific text. + +## Testing + +`packages/ui/tui/tests/tui.spec.ts` pins deterministic bank selection with an injected random source, the reveal (a bank member fully rendered, cursor frames observed), the configured-welcome path rendering verbatim with no cursor, and dispose stopping a mid-reveal animation. `examples/tui-agent/tests/tui-keyless-smoke.e2e.ts` boots the real tree in a PTY and waits on the reveal cursor. Verified live in tmux (mid-reveal frame `no map below▌` then the full slogan). diff --git a/.agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.zh.md b/.agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.zh.md new file mode 100644 index 0000000000..58fa5790f3 --- /dev/null +++ b/.agents/notes/implemented/feature/2026-07-20-tui-startup-slogans.zh.md @@ -0,0 +1,39 @@ +# Agent Note: 启动 slogan 取代配置化的 TUI 欢迎语 + +Status: implemented + +[English](2026-07-20-tui-startup-slogans.md) | 中文 + +> **已被取代**：slogan/动画的那一半由[横幅扫入 Agent Note](2026-07-21-tui-banner-sweep.md)取代：slogan 库和打字机动画上线后实际使用中显得怪异，已替换为无副标题的横幅加整体扫入。移除示例配置中欢迎语的决定与动画生命周期基础设施（`ui.start()` 后启动、经 `detachListeners` 清除）保持不变。 + +## Problem + +TUI 头部副标题来自一个 `welcome` 配置，示例叶子配置把它设为 "TUI agent ready. Give it a coding task."——一句说明书式的填充语，对老用户毫无信息量，每次启动都在复述产品是什么，而且它还有一个硬编码的孪生兄弟（`'ready.'`）作为两个包里的 schema 默认值。产品需要的是一个有性格的启动时刻，而不是一条静态横幅说明。 + +## Decision + +- `examples/tui-agent/cordis.yml` 不再配置 `welcome`；该配置键保留给需要固定、确定性副标题的部署与 fixture（Code Mode overlay 和所有快照/脚本化 fixture 都保留各自的欢迎语）。 +- `welcome` 未设置时，`dsh-tui` 每次启动从导出的 `STARTUP_SLOGANS` 库里挑选一条（`pickStartupSlogan`，随机源可注入），并以打字机动画逐字显示：每帧 40 ms 一个字符，完成前尾随一个 `▌` 块状光标。动画只在 `ui.start()` 成功后启动，其定时器与其他监听器一起在 dispose 时清除。 +- slogan 库是展示文案，刻意不做成配置：想控制措辞的部署已经有 `welcome` 这个出口。按契约 slogan 只含 ASCII，因为逐字显示按字符切片。 +- `dsh-tui-demo` 只在配置了 `welcome` 时才转发它，不再填默认值，应用不再替 TUI 决定空闲副标题。 +- 无 key 的 PTY 启动场景改为等待逐字显示的光标（`▌`——空 transcript 里该字形的唯一来源），不再等待已删除的欢迎文本。 + +同一变更把 `packages/ui/tui/src/index.ts` 恢复到 100% 的单文件覆盖率（颜色方案合并曾在集成分支上破坏它）：`applyColorScheme` 里对编辑器边框颜色的重新赋值是死代码（紧随其后的 `setStatus` 调用会重新推导它），已删除；颜色方案查询的 `.then`/`.catch` 箭头函数改为具名、有测试的处理器（`applyReportedScheme`、`ignoreSchemeQueryFailure`——后者由一个让终端在 DSR 查询写入时抛错的测试固定）。 + +## Alternatives considered + +**换一条更酷的固定 slogan。** 否决：一条每次启动都重读的字符串会和它取代的那行一样退化成墙纸；一个小的轮换库以零复杂度代价让这个时刻保持新鲜。 + +**把 slogan 库和显示速度做成配置。** 否决：那是为展示文案新增两个旋钮；对措辞有主张的部署已经有 `welcome` 这个出口，而「插件里不许硬编码可调参数」规则针对的是随部署变化的行为，不是品牌文案。 + +**在 `HeaderComponent` 内部做动画。** 否决：组件将需要持有 TUI 句柄和自己的生命周期；聊天层已经拥有渲染循环、定时器和释放路径，所以逐字显示与 `createTuiChat` 的其他资源放在一起，由 `detachListeners` 清除。 + +## Consequences + +- `welcome` 未设置时启动输出不再字节级确定（随机 slogan、定时帧）。所有录制或快照表面都显式固定 `welcome`，因此没有快照变化；PTY 冒烟测试改为锚定逐字显示光标和会话 id 行。 +- `welcome` 的 schema 默认值从 `dsh-tui` 和 `dsh-tui-demo` 中消失；不传 welcome 的直接调用方现在得到的是 slogan，而不是 `'ready.'`。 +- 新增一条 slogan 只需在库里加一行；测试断言成员归属，不断言具体文本。 + +## Testing + +`packages/ui/tui/tests/tui.spec.ts` 固定以下行为：注入随机源后的确定性选取、逐字显示（库中某条完整渲染、观察到光标帧）、配置了 welcome 时逐字动画不启动且原文渲染、以及 dispose 停止进行中的动画。`examples/tui-agent/tests/tui-keyless-smoke.e2e.ts` 在 PTY 里启动真实配置树并等待显示光标。已在 tmux 中实机验证（中途帧 `no map below▌`，随后是完整 slogan）。 diff --git a/.agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.i18n.yaml b/.agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.i18n.yaml new file mode 100644 index 0000000000..a06145f092 --- /dev/null +++ b/.agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.i18n.yaml @@ -0,0 +1,6 @@ +# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each +# side as of the last confirmed-consistent state. Both languages carry equal authority; +# after editing either side, bring the other along and re-record with: +# pnpm run verify-translation-pairing --write +2026-07-21-tui-banner-sweep.md: c146424d53e75a72b63e346f87a5bbd206d67350 +2026-07-21-tui-banner-sweep.zh.md: 01cc153e88f067b7b8d2eb6317648f3892fe8a5a diff --git a/.agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.md b/.agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.md new file mode 100644 index 0000000000..c146424d53 --- /dev/null +++ b/.agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.md @@ -0,0 +1,35 @@ +# Agent Note: The banner sweeps in; the subtitle line is gone + +Status: implemented + +English | [中文](2026-07-21-tui-banner-sweep.zh.md) + +> **Superseded** by the [no-banner Agent Note](2026-07-21-tui-no-banner.md): the banner itself was removed, taking the sweep with it. + +## Problem + +The [startup-slogans Agent Note](2026-07-20-tui-startup-slogans.md) replaced the instructional welcome line with a random slogan bank revealed by a per-character typewriter. In use the quotes read as weird — random flavor text in a tool's header — and the animation was slow (40 ms/char over a full sentence) while animating only one line of a four-line banner. This note supersedes that decision's slogan half; the removal of the configured demo welcome and the animation-lifecycle groundwork stand. + +## Decision + +- The slogan bank, `pickStartupSlogan`, and the typewriter reveal are deleted. When `welcome` is unset the banner simply has **no subtitle line** — title and model/session detail only. The `welcome` config remains for deployments and fixtures that want a fixed subtitle, rendered frame-deterministically with no animation. +- The startup animation is now the **whole banner**: `HeaderComponent` gains a `revealWidth` clip, and the header box wipes in left-to-right over ~24 frames at 15 ms (~360 ms total, ~60 fps), started after `ui.start()` succeeds and cleared through the same `detachListeners` path the typewriter used. `stopBannerReveal` also resets the clip so a disposed-mid-sweep header re-renders whole. +- The PTY smoke's boot marker changes from the typewriter cursor (`▌`) to the banner's top-right corner (`╮`), which only renders once the sweep completes. + +## Alternatives considered + +**Keep the animation as-is and only change the copy.** Rejected: any fixed or rotating phrase re-read on every boot decays into wallpaper; the user's judgment was that the quotes themselves, not just their content, were wrong for the surface. + +**Animate per banner line (top-down) instead of a left-right sweep.** Rejected: with only four lines the animation would have four visible steps — closer to a flicker than a reveal; the horizontal sweep uses the full terminal width for a smooth motion at the same total duration. + +**Character-level clipping via `revealWidth` on styled text.** Adopted with `truncateToWidth` from pi-tui, the same ANSI-aware clipper the header already uses for width overflow, so the sweep cannot tear escape sequences. + +## Consequences + +- Boot output with `welcome` unset is again animation-dependent but no longer random: every boot sweeps the same banner. Configured welcomes (all snapshot/scripted fixtures, the Code Mode overlay) stay frame-deterministic and unchanged. +- The `STARTUP_SLOGANS`/`pickStartupSlogan` exports are gone; no consumer outside the deleted tests referenced them. +- The default banner is one line shorter (no subtitle), so PTY assertions anchored on banner geometry use the corner glyph rather than any subtitle text. + +## Testing + +`packages/ui/tui/tests/tui.spec.ts` pins: the sweep completes to a full banner (both corners + title) and produced at least one clipped mid-sweep frame; a configured welcome renders verbatim with no clipped frames; the unset-welcome banner has no subtitle; and dispose clears the sweep's own interval handle. The PTY smoke boots on the `╮` completion marker across the tui-demo bin, the dsh CLI, and the personal-overlay scenarios. Verified live in tmux. diff --git a/.agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.zh.md b/.agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.zh.md new file mode 100644 index 0000000000..01cc153e88 --- /dev/null +++ b/.agents/notes/implemented/feature/2026-07-21-tui-banner-sweep.zh.md @@ -0,0 +1,35 @@ +# Agent Note: 横幅整体扫入；副标题行移除 + +Status: implemented + +[English](2026-07-21-tui-banner-sweep.md) | 中文 + +> **已被取代**：由[移除启动横幅 Agent Note](2026-07-21-tui-no-banner.md)取代：横幅本身已移除，扫入动画随之移除。 + +## Problem + +[启动 slogan Agent Note](2026-07-20-tui-startup-slogans.md) 用随机 slogan 库加逐字打字机动画取代了说明书式的欢迎行。实际使用中这些引语显得怪异——工具头部出现随机的风味文案——而且动画很慢（每字符 40 ms，扫完一整句），却只动画四行横幅中的一行。本 note 取代该决定中 slogan 的那一半；移除示例配置中欢迎语的决定与动画生命周期的基础设施保持不变。 + +## Decision + +- 删除 slogan 库、`pickStartupSlogan` 和打字机动画。`welcome` 未设置时横幅直接**没有副标题行**——只有标题和模型/会话详情。`welcome` 配置保留给想要固定副标题的部署与 fixture，无动画、逐帧确定地渲染。 +- 启动动画现在作用于**整个横幅**：`HeaderComponent` 增加 `revealWidth` 裁剪，头部盒子以约 24 帧、每帧 15 ms（总计约 360 ms、约 60 fps）从左到右扫入，在 `ui.start()` 成功后启动，经打字机动画用过的同一条 `detachListeners` 路径清除。`stopBannerReveal` 同时重置裁剪，因此扫入中途被 dispose 的头部会重新完整渲染。 +- PTY 冒烟测试的启动标记从打字机光标（`▌`）改为横幅右上角（`╮`），它只在扫入完成后才渲染。 + +## Alternatives considered + +**保留动画原样、只改文案。** 否决：任何每次启动都被重读的固定或轮换语句都会退化成墙纸；用户的判断是引语本身——而不只是内容——对这个表面来说就是错的。 + +**按横幅行逐行（自上而下）动画而非左右扫入。** 否决：只有四行时动画只有四个可见步骤——更像闪烁而不是展开；水平扫入用满终端宽度，在相同总时长内动作更平滑。 + +**用 `revealWidth` 对带样式文本做字符级裁剪。** 采用 pi-tui 的 `truncateToWidth`——头部处理宽度溢出时已在使用的同一个 ANSI 感知裁剪器——因此扫入不可能撕裂转义序列。 + +## Consequences + +- `welcome` 未设置时启动输出再次依赖动画但不再随机：每次启动扫入同一幅横幅。配置了欢迎语的场景（全部快照/脚本化 fixture、Code Mode overlay）保持逐帧确定且不变。 +- `STARTUP_SLOGANS`/`pickStartupSlogan` 导出移除；除被删除的测试外没有消费者引用它们。 +- 默认横幅少一行（无副标题），因此锚定横幅几何的 PTY 断言使用角落字形而非任何副标题文本。 + +## Testing + +`packages/ui/tui/tests/tui.spec.ts` 固定：扫入完成为完整横幅（两个角 + 标题）且产生了至少一个裁剪的中途帧；配置的欢迎语原文渲染且无裁剪帧；未设置欢迎语的横幅没有副标题；dispose 清除扫入自己的定时器句柄。PTY 冒烟测试在 tui-demo bin、dsh CLI 和个人 overlay 场景中以 `╮` 完成标记启动。已在 tmux 中实机验证。 diff --git a/.agents/notes/implemented/feature/2026-07-21-tui-no-banner.i18n.yaml b/.agents/notes/implemented/feature/2026-07-21-tui-no-banner.i18n.yaml new file mode 100644 index 0000000000..e9ef3a7671 --- /dev/null +++ b/.agents/notes/implemented/feature/2026-07-21-tui-no-banner.i18n.yaml @@ -0,0 +1,6 @@ +# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each +# side as of the last confirmed-consistent state. Both languages carry equal authority; +# after editing either side, bring the other along and re-record with: +# pnpm run verify-translation-pairing --write +2026-07-21-tui-no-banner.md: 284d02df4b1fe3445a76b030aa873164081aa571 +2026-07-21-tui-no-banner.zh.md: 83bf7ffa27ca1abef0e71a1847b5aa1bd54bbe87 diff --git a/.agents/notes/implemented/feature/2026-07-21-tui-no-banner.md b/.agents/notes/implemented/feature/2026-07-21-tui-no-banner.md new file mode 100644 index 0000000000..284d02df4b --- /dev/null +++ b/.agents/notes/implemented/feature/2026-07-21-tui-no-banner.md @@ -0,0 +1,37 @@ +# Agent Note: No startup banner + +Status: implemented + +English | [中文](2026-07-21-tui-no-banner.zh.md) + +## Problem + +The TUI opened with a boxed product banner ("DEEPSEEK HARNESS" + model/session detail), most recently with a sweep-in animation ([banner sweep Agent Note](2026-07-21-tui-banner-sweep.md)). The user's verdict: remove it. A product title re-read on every boot is chrome, the box spends four rows before any content, and the identifying facts it carried (model, session) have better homes. + +## Decision + +- `HeaderComponent`, the sweep animation, and its lifecycle wiring are deleted. The TUI mounts straight into the transcript; startup renders nothing above the separator. +- The model name moves into the footer status line's left segment (` ↑tokens ↓tokens`), so the session's driving model stays visible at all times, not just at boot. The session id is no longer displayed — it lives in the session log and `./.sessions` filenames, and `RESUME_SESSION_ID` consumers retrieve it there. +- `welcome`, when configured, renders as the transcript's first line (a muted notice) inside `rebuildTranscript`, so palette swaps preserve it. Unset renders nothing. Fixtures keep their configured welcomes; the PTY smoke's boot marker becomes the footer's model name, the only mounted-TUI text guaranteed to render regardless of cwd length. + +This supersedes the [banner sweep Agent Note](2026-07-21-tui-banner-sweep.md) entirely: both the sweep and the banner it animated are gone. + +## Alternatives considered + +**Keep a one-line header (no box).** Rejected: the only load-bearing fact was the model name, and the footer already aggregates session status; a dedicated header row for one fact is the same chrome, smaller. + +**Show the session id in the footer too.** Rejected: a 36-char UUID dominates the 100-column footer and clips the status segment; it identifies the session for resume, which is a log/filesystem concern, not a glanceable one. + +**Print the welcome outside the transcript (above the separator).** Rejected: any fixed region above the transcript is a banner again; as a transcript line it scrolls away naturally and survives rebuilds through the same path as every other transcript element. + +## Consequences + +- Startup output is fully deterministic again — no animation frames at all; the interval-lifecycle machinery from the two animation iterations is gone. +- All 26 pi-tui terminal snapshots re-recorded (`test:snapshot:refresh`): banner rows gone, footer rows gain the model prefix. +- Anything that anchored on banner text (`DEEPSEEK`, box corners) re-anchors on the footer model name; `main-session-` no longer appears in boot output. +- `/clear` now wipes the welcome line too: it is an ordinary transcript line, and `/clear` empties the transcript (the old banner survived `/clear` only by sitting outside it). +- The footer's left segment is wider; on narrow terminals the right status segment clips earlier. + +## Testing + +`packages/ui/tui/tests/tui.spec.ts` pins: no box corners/product title and an empty transcript when `welcome` is unset, with the model in the footer; a configured welcome as the first transcript line without a banner; and the welcome surviving a palette-swap transcript rebuild. The PTY smoke boots on the footer model name and asserts `DEEPSEEK HARNESS` is absent. Snapshots verify the full frames. diff --git a/.agents/notes/implemented/feature/2026-07-21-tui-no-banner.zh.md b/.agents/notes/implemented/feature/2026-07-21-tui-no-banner.zh.md new file mode 100644 index 0000000000..83bf7ffa27 --- /dev/null +++ b/.agents/notes/implemented/feature/2026-07-21-tui-no-banner.zh.md @@ -0,0 +1,37 @@ +# Agent Note: 移除启动横幅 + +Status: implemented + +[English](2026-07-21-tui-no-banner.md) | 中文 + +## Problem + +TUI 启动时展示一个带框的产品横幅（"DEEPSEEK HARNESS" + 模型/会话详情），最近一版还带扫入动画（[横幅扫入 Agent Note](2026-07-21-tui-banner-sweep.md)）。用户的裁决：删掉它。每次启动都被重读的产品标题是装饰，盒子在任何内容之前先占掉四行，而它承载的识别信息（模型、会话）有更好的去处。 + +## Decision + +- 删除 `HeaderComponent`、扫入动画及其生命周期接线。TUI 直接挂载进 transcript；启动时分隔线之上不渲染任何东西。 +- 模型名移入页脚状态行的左段（` ↑tokens ↓tokens`），会话使用的模型因此始终可见，而不只是启动时。会话 id 不再显示——它存在于会话日志和 `./.sessions` 文件名中，`RESUME_SESSION_ID` 的使用者从那里获取。 +- 配置了 `welcome` 时，它作为 transcript 的第一行（一条弱化的通知）在 `rebuildTranscript` 内渲染，因此调色板切换会保留它。未设置则什么也不渲染。fixture 保留各自配置的欢迎语；PTY 冒烟测试的启动标记改为页脚的模型名——无论 cwd 多长都保证渲染的唯一挂载后文本。 + +本 note 完全取代[横幅扫入 Agent Note](2026-07-21-tui-banner-sweep.md)：扫入动画和它所动画的横幅都已移除。 + +## Alternatives considered + +**保留单行头部（去掉盒子）。** 否决：唯一有承载价值的信息是模型名，而页脚已经聚合会话状态；为一条信息保留专用头部行仍是同一种装饰，只是小一点。 + +**把会话 id 也放进页脚。** 否决：36 字符的 UUID 会占满 100 列页脚并裁掉状态段；它的用途是恢复会话的标识，属于日志/文件系统关注点，不是需要一瞥可见的信息。 + +**把欢迎语渲染在 transcript 之外（分隔线上方）。** 否决：transcript 上方任何固定区域都会再次变成横幅；作为 transcript 行它自然滚走，并通过与其他 transcript 元素相同的路径在重建后保留。 + +## Consequences + +- 启动输出再次完全确定——没有任何动画帧；两轮动画迭代留下的定时器生命周期机制全部移除。 +- 全部 26 个 pi-tui 终端快照重新录制（`test:snapshot:refresh`）：横幅行消失，页脚行增加模型前缀。 +- 锚定横幅文本（`DEEPSEEK`、盒子角）的内容改为锚定页脚模型名；启动输出中不再出现 `main-session-`。 +- `/clear` 现在也会清掉欢迎行：它是普通的 transcript 行，而 `/clear` 清空 transcript（旧横幅能在 `/clear` 后存活只因为它在 transcript 之外）。 +- 页脚左段变宽；窄终端上右侧状态段更早被裁剪。 + +## Testing + +`packages/ui/tui/tests/tui.spec.ts` 固定：`welcome` 未设置时无盒子角/产品标题、transcript 为空、模型在页脚；配置的欢迎语作为 transcript 第一行且无横幅；欢迎语在调色板切换的 transcript 重建后保留。PTY 冒烟测试以页脚模型名为启动标记并断言 `DEEPSEEK HARNESS` 不出现。快照验证完整帧。 diff --git a/examples/tui-agent/tests/snapshots/bash-terminal-card/terminal.expected.txt b/examples/tui-agent/tests/snapshots/bash-terminal-card/terminal.expected.txt index e03725cc4f..5b7505cc54 100644 --- a/examples/tui-agent/tests/snapshots/bash-terminal-card/terminal.expected.txt +++ b/examples/tui-agent/tests/snapshots/bash-terminal-card/terminal.expected.txt @@ -1,73 +1,63 @@ terminal 100x36 buffer=normal length=36 base=0 viewport=0 lifecycle started=1 stopped=0 progress=inactive -title "Use the bash tool to — DSH TUI snapshot" -cursor hidden column=1 viewportRow=27 bufferRow=27 +title "DSH TUI snapshot" +cursor hidden column=1 viewportRow=25 bufferRow=25 buffer -0| "╭──────────────────────────────────────────────────────────────────────────────────────────────────╮" - style 0-99 fg=bright-blue -1| "│ DEEPSEEK HARNESS │" +0| " DEEPSEEK HARNESS" + style 1-8 fg=bright-blue bold + style 10-16 bold +1| " Recorded replay: bash-terminal-card" + style 1-35 fg=bright-black +2| " deepseek-v4-flash • main-session" + style 1-34 dim +3| +4| "▌ " style 0-0 fg=bright-blue - style 2-9 fg=bright-blue bold - style 11-17 bold - style 99-99 fg=bright-blue -2| "│ Use the bash tool to │" - style 0-0 fg=bright-blue - style 2-21 fg=bright-black - style 99-99 fg=bright-blue -3| "│ deepseek-v4-flash • main-session │" - style 0-0 fg=bright-blue - style 2-35 dim - style 99-99 fg=bright-blue -4| "╰──────────────────────────────────────────────────────────────────────────────────────────────────╯" - style 0-99 fg=bright-blue -5| -6| "▌ " - style 0-0 fg=bright-blue -7| "▌ You " +5| "▌ You " style 0-0 fg=bright-blue style 2-4 fg=bright-blue bold -8| "▌ Use the bash tool to run exactly: echo TERMINAL_OK. Then reply with the single word DONE and stop." +6| "▌ Use the bash tool to run exactly: echo TERMINAL_OK. Then reply with the single word DONE and stop." style 0-0 fg=bright-blue -9| "▌ " +7| "▌ " style 0-0 fg=bright-blue -10| -11| " Reasoning " +8| +9| " Reasoning " style 1-9 fg=bright-black italic -12| " The user wants me to run a simple bash command and then reply with \"DONE\". " +10| " The user wants me to run a simple bash command and then reply with \"DONE\". " style 1-74 fg=bright-black italic -13| -14| "▌ " +11| +12| "▌ " style 0-0 fg=green -15| "▌ ✓ echo TERMINAL_OK " +13| "▌ ✓ echo TERMINAL_OK " style 0-0 fg=green style 2-2 fg=green bold style 3-19 bold -16| "▌ Echo TERMINAL_OK to verify terminal access " +14| "▌ Echo TERMINAL_OK to verify terminal access " style 0-0 fg=green style 2-43 fg=bright-black -17| "▌ TERMINAL_OK " +15| "▌ TERMINAL_OK " style 0-0 fg=green -18| "▌ [exit 0] " +16| "▌ [exit 0] " style 0-0 fg=green style 2-9 dim -19| "▌ " +17| "▌ " style 0-0 fg=green -20| -21| " Reasoning " +18| +19| " Reasoning " style 1-9 fg=bright-black italic -22| " The command ran successfully and output \"TERMINAL_OK\". I should now reply with just \"DONE\". " +20| " The command ran successfully and output \"TERMINAL_OK\". I should now reply with just \"DONE\". " style 1-91 fg=bright-black italic -23| -24| " Assistant " +21| +22| " Assistant " style 1-9 fg=bright-magenta bold -25| " DONE " +23| " DONE " +24| "────────────────────────────────────────────────────────────────────────────────────────────────────" + style 0-99 dim +25| " " + style 1-1 inverse 26| "────────────────────────────────────────────────────────────────────────────────────────────────────" style 0-99 dim -27| " " - style 1-1 inverse -28| "────────────────────────────────────────────────────────────────────────────────────────────────────" - style 0-99 dim -29| "/tmp/dsh-tui-snapshot-bash-te ↑3.0k ↓115 3% context tools:compact deepseek-v4-flash(reasoning:on)" - style 0-28 dim - style 42-99 dim -30-35| +27| "deepseek-v4-flash /workspace/project ↑3.0k ↓115 cache 48% tools:col" + style 0-88 dim + style 91-99 dim +28-35| diff --git a/examples/tui-agent/tests/snapshots/code-mode/terminal.expected.txt b/examples/tui-agent/tests/snapshots/code-mode/terminal.expected.txt index c774373268..b1a587e71f 100644 --- a/examples/tui-agent/tests/snapshots/code-mode/terminal.expected.txt +++ b/examples/tui-agent/tests/snapshots/code-mode/terminal.expected.txt @@ -1,79 +1,69 @@ terminal 100x36 buffer=normal length=36 base=0 viewport=0 lifecycle started=1 stopped=0 progress=inactive -title "Using ONE run_code program: call — DSH TUI snapshot" -cursor hidden column=1 viewportRow=29 bufferRow=29 +title "DSH TUI snapshot" +cursor hidden column=1 viewportRow=27 bufferRow=27 buffer -0| "╭──────────────────────────────────────────────────────────────────────────────────────────────────╮" - style 0-99 fg=bright-blue -1| "│ DEEPSEEK HARNESS │" +0| " DEEPSEEK HARNESS" + style 1-8 fg=bright-blue bold + style 10-16 bold +1| " Recorded replay: code-mode" + style 1-26 fg=bright-black +2| " deepseek-v4-flash • main-session" + style 1-34 dim +3| +4| "▌ " style 0-0 fg=bright-blue - style 2-9 fg=bright-blue bold - style 11-17 bold - style 99-99 fg=bright-blue -2| "│ Using ONE run_code program: call │" - style 0-0 fg=bright-blue - style 2-33 fg=bright-black - style 99-99 fg=bright-blue -3| "│ deepseek-v4-flash • main-session │" - style 0-0 fg=bright-blue - style 2-35 dim - style 99-99 fg=bright-blue -4| "╰──────────────────────────────────────────────────────────────────────────────────────────────────╯" - style 0-99 fg=bright-blue -5| -6| "▌ " - style 0-0 fg=bright-blue -7| "▌ You " +5| "▌ You " style 0-0 fg=bright-blue style 2-4 fg=bright-blue bold -8| "▌ Using ONE run_code program: call the bash tool twice — exactly echo CODE_ONE then exactly echo " +6| "▌ Using ONE run_code program: call the bash tool twice — exactly echo CODE_ONE then exactly echo " style 0-0 fg=bright-blue style 65-77 fg=cyan style 92-99 fg=cyan -9| "▌ CODE_TWO — and return the two outputs joined with a plus sign. Then reply with that joined string " +7| "▌ CODE_TWO — and return the two outputs joined with a plus sign. Then reply with that joined string " style 0-0 fg=bright-blue style 2-9 fg=cyan -10| "▌ only and stop. " +8| "▌ only and stop. " style 0-0 fg=bright-blue -11| "▌ " +9| "▌ " style 0-0 fg=bright-blue -12| -13| " Reasoning " +10| +11| " Reasoning " style 1-9 fg=bright-black italic -14| " The user wants a single run_code program that calls bash twice, then returns the two outputs " +12| " The user wants a single run_code program that calls bash twice, then returns the two outputs " style 1-99 fg=bright-black italic -15| " joined with a plus sign. Let me write this. " +13| " joined with a plus sign. Let me write this. " style 1-43 fg=bright-black italic -16| -17| "▌ " +14| +15| "▌ " style 0-0 fg=green -18| "▌ ✓ const out1 = await tools.bash({ command: \"echo CODE_ONE\", description: \"First echo\" }); " +16| "▌ ✓ const out1 = await tools.bash({ command: \"echo CODE_ONE\", description: \"First echo\" }); " style 0-0 fg=green style 2-2 fg=green bold style 3-99 bold -19| "▌ const o " +17| "▌ const o " style 0-0 fg=green style 2-8 bold -20| "▌ CODE_ONE+CODE_TWO " +18| "▌ CODE_ONE+CODE_TWO " style 0-0 fg=green -21| "▌ " +19| "▌ " style 0-0 fg=green -22| -23| " Reasoning " +20| +21| " Reasoning " style 1-9 fg=bright-black italic -24| " The output is exactly what the user asked for: CODE_ONE+CODE_TWO " +22| " The output is exactly what the user asked for: CODE_ONE+CODE_TWO " style 1-64 fg=bright-black italic -25| -26| " Assistant " +23| +24| " Assistant " style 1-9 fg=bright-magenta bold -27| " CODE_ONE+CODE_TWO " +25| " CODE_ONE+CODE_TWO " +26| "────────────────────────────────────────────────────────────────────────────────────────────────────" + style 0-99 dim +27| " " + style 1-1 inverse 28| "────────────────────────────────────────────────────────────────────────────────────────────────────" style 0-99 dim -29| " " - style 1-1 inverse -30| "────────────────────────────────────────────────────────────────────────────────────────────────────" - style 0-99 dim -31| "/tmp/dsh-tui-snapshot-code-mo ↑3.1k ↓158 3% context tools:compact deepseek-v4-flash(reasoning:on)" - style 0-28 dim - style 42-99 dim -32-35| +29| "deepseek-v4-flash /workspace/project ↑3.1k ↓158 cache 50% tools:collapsed" + style 0-79 dim + style 85-99 dim +30-35| diff --git a/examples/tui-agent/tests/snapshots/cordis-dynamic-toolchain/terminal.expected.txt b/examples/tui-agent/tests/snapshots/cordis-dynamic-toolchain/terminal.expected.txt index 51ef90684a..e0b6a4c1fb 100644 --- a/examples/tui-agent/tests/snapshots/cordis-dynamic-toolchain/terminal.expected.txt +++ b/examples/tui-agent/tests/snapshots/cordis-dynamic-toolchain/terminal.expected.txt @@ -1,116 +1,106 @@ -terminal 100x36 buffer=normal length=50 base=14 viewport=14 +terminal 100x36 buffer=normal length=48 base=12 viewport=12 lifecycle started=1 stopped=0 progress=inactive -title "Run this advanced flow exactly — DSH TUI snapshot" -cursor hidden column=1 viewportRow=33 bufferRow=47 +title "DSH TUI snapshot" +cursor hidden column=1 viewportRow=33 bufferRow=45 buffer -0| "╭──────────────────────────────────────────────────────────────────────────────────────────────────╮" - style 0-99 fg=bright-blue -1| "│ DEEPSEEK HARNESS │" +0| " DEEPSEEK HARNESS" + style 1-8 fg=bright-blue bold + style 10-16 bold +1| " Recorded replay: cordis-dynamic-toolchain" + style 1-41 fg=bright-black +2| " deepseek-v4-flash • main-session" + style 1-34 dim +3| +4| "▌ " style 0-0 fg=bright-blue - style 2-9 fg=bright-blue bold - style 11-17 bold - style 99-99 fg=bright-blue -2| "│ Run this advanced flow exactly │" - style 0-0 fg=bright-blue - style 2-31 fg=bright-black - style 99-99 fg=bright-blue -3| "│ deepseek-v4-flash • main-session │" - style 0-0 fg=bright-blue - style 2-35 dim - style 99-99 fg=bright-blue -4| "╰──────────────────────────────────────────────────────────────────────────────────────────────────╯" - style 0-99 fg=bright-blue -5| -6| "▌ " - style 0-0 fg=bright-blue -7| "▌ You " +5| "▌ You " style 0-0 fg=bright-blue style 2-4 fg=bright-blue bold -8| "▌ Run this advanced flow exactly once: mount a no-op Cordis plugin named snapshot-marker; use " +6| "▌ Run this advanced flow exactly once: mount a no-op Cordis plugin named snapshot-marker; use " style 0-0 fg=bright-blue -9| "▌ run_code to inspect the live dynamic mounts through tools.cordis_inspect; delegate once to a " +7| "▌ run_code to inspect the live dynamic mounts through tools.cordis_inspect; delegate once to a " style 0-0 fg=bright-blue -10| "▌ direct spawn child; run one workflow that delegates to another spawn child; unmount dyn-1; then " +8| "▌ direct spawn child; run one workflow that delegates to another spawn child; unmount dyn-1; then " style 0-0 fg=bright-blue -11| "▌ reply with exactly ADVANCED_ACP_OK. " +9| "▌ reply with exactly ADVANCED_ACP_OK. " style 0-0 fg=bright-blue +10| "▌ " + style 0-0 fg=bright-blue +11| 12| "▌ " - style 0-0 fg=bright-blue -13| -14| "▌ " style 0-0 fg=green -15| "▌ ✓ Mount plugin into live cordis runtime " +13| "▌ ✓ Mount plugin into live cordis runtime " style 0-0 fg=green style 2-2 fg=green bold style 3-40 bold -16| "▌ mounted dyn-1 (plugin \"snapshot-marker\", state: active) " +14| "▌ mounted dyn-1 (plugin \"snapshot-marker\", state: active) " style 0-0 fg=green +15| "▌ " + style 0-0 fg=green +16| 17| "▌ " style 0-0 fg=green -18| -19| "▌ " - style 0-0 fg=green -20| "▌ ✓ return await tools.cordis_inspect({ what: 'dynamic' }) " +18| "▌ ✓ return await tools.cordis_inspect({ what: 'dynamic' }) " style 0-0 fg=green style 2-2 fg=green bold style 3-57 bold -21| "▌ ## dynamic " +19| "▌ ## dynamic " style 0-0 fg=green -22| "▌ - dyn-1: snapshot-marker [active] " +20| "▌ - dyn-1: snapshot-marker [active] " style 0-0 fg=green +21| "▌ " + style 0-0 fg=green +22| 23| "▌ " style 0-0 fg=green -24| -25| "▌ " - style 0-0 fg=green -26| "▌ ✓ subagent " +24| "▌ ✓ subagent " style 0-0 fg=green style 2-2 fg=green bold style 3-11 bold -27| "▌ DIRECT_CHILD_OK " +25| "▌ DIRECT_CHILD_OK " style 0-0 fg=green +26| "▌ " + style 0-0 fg=green +27| 28| "▌ " style 0-0 fg=green -29| -30| "▌ " - style 0-0 fg=green -31| "▌ ✓ workflow: advanced-acp-snapshot " +29| "▌ ✓ workflow: advanced-acp-snapshot " style 0-0 fg=green style 2-2 fg=green bold style 3-34 bold -32| "▌ workflow \"advanced-acp-snapshot\" completed (1 agent). " +30| "▌ workflow \"advanced-acp-snapshot\" completed (1 agent). " style 0-0 fg=green -33| "▌ Return value: " +31| "▌ Return value: " style 0-0 fg=green -34| "▌ { " +32| "▌ { " style 0-0 fg=green -35| "▌ \"reply\": \"WORKFLOW_CHILD_OK\" " +33| "▌ \"reply\": \"WORKFLOW_CHILD_OK\" " style 0-0 fg=green -36| "▌ } " +34| "▌ } " style 0-0 fg=green +35| "▌ " + style 0-0 fg=green +36| 37| "▌ " style 0-0 fg=green -38| -39| "▌ " - style 0-0 fg=green -40| "▌ ✓ Unmount dyn-1 " +38| "▌ ✓ Unmount dyn-1 " style 0-0 fg=green style 2-2 fg=green bold style 3-16 bold -41| "▌ unmounted dyn-1 (plugin \"snapshot-marker\") " +39| "▌ unmounted dyn-1 (plugin \"snapshot-marker\") " style 0-0 fg=green -42| "▌ " +40| "▌ " style 0-0 fg=green -43| -44| " Assistant " +41| +42| " Assistant " style 1-9 fg=bright-magenta bold -45| " ADVANCED_ACP_OK " +43| " ADVANCED_ACP_OK " +44| "────────────────────────────────────────────────────────────────────────────────────────────────────" + style 0-99 dim +45| " " + style 1-1 inverse 46| "────────────────────────────────────────────────────────────────────────────────────────────────────" style 0-99 dim -47| " " - style 1-1 inverse -48| "────────────────────────────────────────────────────────────────────────────────────────────────────" - style 0-99 dim -49| "/tmp/dsh-tui-snapshot-cordis-dyn ↑18 ↓18 7% context tools:compact deepseek-v4-flash(reasoning:on)" - style 0-31 dim - style 42-99 dim +47| "deepseek-v4-flash /workspace/project ↑18 ↓18 cache 0% tools:c" + style 0-90 dim + style 93-99 dim diff --git a/examples/tui-agent/tests/snapshots/dynamic-workflow/terminal.expected.txt b/examples/tui-agent/tests/snapshots/dynamic-workflow/terminal.expected.txt index 114026295e..fd88ea5b40 100644 --- a/examples/tui-agent/tests/snapshots/dynamic-workflow/terminal.expected.txt +++ b/examples/tui-agent/tests/snapshots/dynamic-workflow/terminal.expected.txt @@ -1,106 +1,96 @@ -terminal 100x36 buffer=normal length=47 base=11 viewport=11 +terminal 100x36 buffer=normal length=45 base=9 viewport=9 lifecycle started=1 stopped=0 progress=inactive -title "Use the workflow tool exactly — DSH TUI snapshot" -cursor hidden column=1 viewportRow=33 bufferRow=44 +title "DSH TUI snapshot" +cursor hidden column=1 viewportRow=33 bufferRow=42 buffer -0| "╭──────────────────────────────────────────────────────────────────────────────────────────────────╮" - style 0-99 fg=bright-blue -1| "│ DEEPSEEK HARNESS │" +0| " DEEPSEEK HARNESS" + style 1-8 fg=bright-blue bold + style 10-16 bold +1| " Recorded replay: dynamic-workflow" + style 1-33 fg=bright-black +2| " deepseek-v4-flash • main-session" + style 1-34 dim +3| +4| "▌ " style 0-0 fg=bright-blue - style 2-9 fg=bright-blue bold - style 11-17 bold - style 99-99 fg=bright-blue -2| "│ Use the workflow tool exactly │" - style 0-0 fg=bright-blue - style 2-30 fg=bright-black - style 99-99 fg=bright-blue -3| "│ deepseek-v4-flash • main-session │" - style 0-0 fg=bright-blue - style 2-35 dim - style 99-99 fg=bright-blue -4| "╰──────────────────────────────────────────────────────────────────────────────────────────────────╯" - style 0-99 fg=bright-blue -5| -6| "▌ " - style 0-0 fg=bright-blue -7| "▌ You " +5| "▌ You " style 0-0 fg=bright-blue style 2-4 fg=bright-blue bold -8| "▌ Use the workflow tool exactly once, with args omitted, meta set to { \"name\": \"snapshot-flow\", " +6| "▌ Use the workflow tool exactly once, with args omitted, meta set to { \"name\": \"snapshot-flow\", " style 0-0 fg=bright-blue -9| "▌ \"description\": \"one child for the snapshot\" }, and this EXACT script body (copy it verbatim): " +7| "▌ \"description\": \"one child for the snapshot\" }, and this EXACT script body (copy it verbatim): " style 0-0 fg=bright-blue -10| "▌ phase('Run') " +8| "▌ phase('Run') " style 0-0 fg=bright-blue -11| "▌ const reply = await agent('Reply with exactly the word WF_CHILD_OK and nothing else.') " +9| "▌ const reply = await agent('Reply with exactly the word WF_CHILD_OK and nothing else.') " style 0-0 fg=bright-blue -12| "▌ return { reply } " +10| "▌ return { reply } " style 0-0 fg=bright-blue -13| "▌ After the workflow returns, reply with the single word WORKFLOW_DONE and stop. Do not use any " +11| "▌ After the workflow returns, reply with the single word WORKFLOW_DONE and stop. Do not use any " style 0-0 fg=bright-blue -14| "▌ other tool. " +12| "▌ other tool. " style 0-0 fg=bright-blue -15| "▌ " +13| "▌ " style 0-0 fg=bright-blue -16| -17| " Reasoning " +14| +15| " Reasoning " style 1-9 fg=bright-black italic -18| " The user wants me to use the workflow tool exactly once with specific parameters. Let me carefully " +16| " The user wants me to use the workflow tool exactly once with specific parameters. Let me carefully " style 1-99 fg=bright-black italic -19| " follow the instructions: " +17| " follow the instructions: " style 1-24 fg=bright-black italic -20| " " -21| " 1. args omitted (so I don't include it) " +18| " " +19| " 1. args omitted (so I don't include it) " style 1-3 fg=bright-blue style 4-39 fg=bright-black italic -22| " 2. meta = { \"name\": \"snapshot-flow\", \"description\": \"one child for the snapshot\" } " +20| " 2. meta = { \"name\": \"snapshot-flow\", \"description\": \"one child for the snapshot\" } " style 1-3 fg=bright-blue style 4-82 fg=bright-black italic -23| " 3. script = as given verbatim " +21| " 3. script = as given verbatim " style 1-3 fg=bright-blue style 4-29 fg=bright-black italic -24| " 4. After it returns, reply with \"WORKFLOW_DONE\" " +22| " 4. After it returns, reply with \"WORKFLOW_DONE\" " style 1-3 fg=bright-blue style 4-47 fg=bright-black italic -25| " " -26| " Let me do exactly that. " +23| " " +24| " Let me do exactly that. " style 1-23 fg=bright-black italic -27| -28| "▌ " +25| +26| "▌ " style 0-0 fg=green -29| "▌ ✓ workflow: snapshot-flow " +27| "▌ ✓ workflow: snapshot-flow " style 0-0 fg=green style 2-2 fg=green bold style 3-26 bold -30| "▌ workflow \"snapshot-flow\" completed (1 agent). " +28| "▌ workflow \"snapshot-flow\" completed (1 agent). " style 0-0 fg=green -31| "▌ Return value: " +29| "▌ Return value: " style 0-0 fg=green -32| "▌ { " +30| "▌ { " style 0-0 fg=green -33| "▌ \"reply\": \"WF_CHILD_OK\" " +31| "▌ \"reply\": \"WF_CHILD_OK\" " style 0-0 fg=green -34| "▌ } " +32| "▌ } " style 0-0 fg=green -35| "▌ " +33| "▌ " style 0-0 fg=green -36| -37| " Reasoning " +34| +35| " Reasoning " style 1-9 fg=bright-black italic -38| " The workflow returned successfully with the reply \"WF_CHILD_OK\". Now I need to reply with exactly " +36| " The workflow returned successfully with the reply \"WF_CHILD_OK\". Now I need to reply with exactly " style 1-99 fg=bright-black italic -39| " \"WORKFLOW_DONE\" and stop. " +37| " \"WORKFLOW_DONE\" and stop. " style 1-25 fg=bright-black italic -40| -41| " Assistant " +38| +39| " Assistant " style 1-9 fg=bright-magenta bold -42| " WORKFLOW_DONE " +40| " WORKFLOW_DONE " +41| "────────────────────────────────────────────────────────────────────────────────────────────────────" + style 0-99 dim +42| " " + style 1-1 inverse 43| "────────────────────────────────────────────────────────────────────────────────────────────────────" style 0-99 dim -44| " " - style 1-1 inverse -45| "────────────────────────────────────────────────────────────────────────────────────────────────────" - style 0-99 dim -46| "/tmp/dsh-tui-snapshot-dynamic ↑3.5k ↓227 3% context tools:compact deepseek-v4-flash(reasoning:on)" - style 0-28 dim - style 42-99 dim +44| "deepseek-v4-flash /workspace/project ↑3.5k ↓227 cache 47% tools:colla" + style 0-86 dim + style 89-99 dim diff --git a/examples/tui-agent/tests/snapshots/multi-turn-conversation/terminal.expected.txt b/examples/tui-agent/tests/snapshots/multi-turn-conversation/terminal.expected.txt index 69b9371fb0..ecc3c796e9 100644 --- a/examples/tui-agent/tests/snapshots/multi-turn-conversation/terminal.expected.txt +++ b/examples/tui-agent/tests/snapshots/multi-turn-conversation/terminal.expected.txt @@ -1,70 +1,60 @@ terminal 100x36 buffer=normal length=36 base=0 viewport=0 lifecycle started=1 stopped=0 progress=inactive -title "Reply with exactly the word: — DSH TUI snapshot" -cursor hidden column=1 viewportRow=28 bufferRow=28 +title "DSH TUI snapshot" +cursor hidden column=1 viewportRow=26 bufferRow=26 buffer -0| "╭──────────────────────────────────────────────────────────────────────────────────────────────────╮" - style 0-99 fg=bright-blue -1| "│ DEEPSEEK HARNESS │" +0| " DEEPSEEK HARNESS" + style 1-8 fg=bright-blue bold + style 10-16 bold +1| " Recorded replay: multi-turn-conversation" + style 1-40 fg=bright-black +2| " deepseek-v4-flash • main-session" + style 1-34 dim +3| +4| "▌ " style 0-0 fg=bright-blue - style 2-9 fg=bright-blue bold - style 11-17 bold - style 99-99 fg=bright-blue -2| "│ Reply with exactly the word: │" - style 0-0 fg=bright-blue - style 2-29 fg=bright-black - style 99-99 fg=bright-blue -3| "│ deepseek-v4-flash • main-session │" - style 0-0 fg=bright-blue - style 2-35 dim - style 99-99 fg=bright-blue -4| "╰──────────────────────────────────────────────────────────────────────────────────────────────────╯" - style 0-99 fg=bright-blue -5| -6| "▌ " - style 0-0 fg=bright-blue -7| "▌ You " +5| "▌ You " style 0-0 fg=bright-blue style 2-4 fg=bright-blue bold -8| "▌ Reply with exactly the word: ONE. No tools. " +6| "▌ Reply with exactly the word: ONE. No tools. " style 0-0 fg=bright-blue -9| "▌ " +7| "▌ " style 0-0 fg=bright-blue -10| -11| " Reasoning " +8| +9| " Reasoning " style 1-9 fg=bright-black italic -12| " The user wants me to reply with exactly the word \"ONE\" and use no tools. " +10| " The user wants me to reply with exactly the word \"ONE\" and use no tools. " style 1-72 fg=bright-black italic -13| -14| " Assistant " +11| +12| " Assistant " style 1-9 fg=bright-magenta bold -15| " ONE " -16| -17| "▌ " +13| " ONE " +14| +15| "▌ " style 0-0 fg=bright-blue -18| "▌ You " +16| "▌ You " style 0-0 fg=bright-blue style 2-4 fg=bright-blue bold -19| "▌ Reply with exactly the word: TWO. No tools. " +17| "▌ Reply with exactly the word: TWO. No tools. " style 0-0 fg=bright-blue -20| "▌ " +18| "▌ " style 0-0 fg=bright-blue -21| -22| " Reasoning " +19| +20| " Reasoning " style 1-9 fg=bright-black italic -23| " The user wants me to reply with exactly the word \"TWO\" and no tools. " +21| " The user wants me to reply with exactly the word \"TWO\" and no tools. " style 1-68 fg=bright-black italic -24| -25| " Assistant " +22| +23| " Assistant " style 1-9 fg=bright-magenta bold -26| " TWO " +24| " TWO " +25| "────────────────────────────────────────────────────────────────────────────────────────────────────" + style 0-99 dim +26| " " + style 1-1 inverse 27| "────────────────────────────────────────────────────────────────────────────────────────────────────" style 0-99 dim -28| " " - style 1-1 inverse -29| "────────────────────────────────────────────────────────────────────────────────────────────────────" - style 0-99 dim -30| "/tmp/dsh-tui-snapshot-multi-tu ↑2.9k ↓41 3% context tools:compact deepseek-v4-flash(reasoning:on)" - style 0-29 dim - style 42-99 dim -31-35| +28| "deepseek-v4-flash /workspace/project ↑2.9k ↓41 cache 49% tools" + style 0-92 dim + style 95-99 dim +29-35| diff --git a/examples/tui-agent/tests/snapshots/parallel-file-reads/terminal.expected.txt b/examples/tui-agent/tests/snapshots/parallel-file-reads/terminal.expected.txt index f56a8f8a24..5fd1a0942e 100644 --- a/examples/tui-agent/tests/snapshots/parallel-file-reads/terminal.expected.txt +++ b/examples/tui-agent/tests/snapshots/parallel-file-reads/terminal.expected.txt @@ -1,91 +1,81 @@ -terminal 100x36 buffer=normal length=39 base=3 viewport=3 +terminal 100x36 buffer=normal length=37 base=1 viewport=1 lifecycle started=1 stopped=0 progress=inactive -title "Use the read tool twice — DSH TUI snapshot" -cursor hidden column=1 viewportRow=33 bufferRow=36 +title "DSH TUI snapshot" +cursor hidden column=1 viewportRow=33 bufferRow=34 buffer -0| "╭──────────────────────────────────────────────────────────────────────────────────────────────────╮" - style 0-99 fg=bright-blue -1| "│ DEEPSEEK HARNESS │" +0| " DEEPSEEK HARNESS" + style 1-8 fg=bright-blue bold + style 10-16 bold +1| " Recorded replay: parallel-file-reads" + style 1-36 fg=bright-black +2| " deepseek-v4-flash • main-session" + style 1-34 dim +3| +4| "▌ " style 0-0 fg=bright-blue - style 2-9 fg=bright-blue bold - style 11-17 bold - style 99-99 fg=bright-blue -2| "│ Use the read tool twice │" - style 0-0 fg=bright-blue - style 2-24 fg=bright-black - style 99-99 fg=bright-blue -3| "│ deepseek-v4-flash • main-session │" - style 0-0 fg=bright-blue - style 2-35 dim - style 99-99 fg=bright-blue -4| "╰──────────────────────────────────────────────────────────────────────────────────────────────────╯" - style 0-99 fg=bright-blue -5| -6| "▌ " - style 0-0 fg=bright-blue -7| "▌ You " +5| "▌ You " style 0-0 fg=bright-blue style 2-4 fg=bright-blue bold -8| "▌ Use the read tool twice in the same assistant message: read a.txt and b.txt. Then reply DONE. " +6| "▌ Use the read tool twice in the same assistant message: read a.txt and b.txt. Then reply DONE. " style 0-0 fg=bright-blue +7| "▌ " + style 0-0 fg=bright-blue +8| 9| "▌ " - style 0-0 fg=bright-blue -10| -11| "▌ " style 0-0 fg=green -12| "▌ ✓ Read a.txt " +10| "▌ ✓ Read a.txt " style 0-0 fg=green style 2-2 fg=green bold style 3-13 bold -13| "▌ /workspace/project/a.txt " +11| "▌ /workspace/project/a.txt " style 0-0 fg=green -14| "▌ file " +12| "▌ file " style 0-0 fg=green -15| "▌ " +13| "▌ " style 0-0 fg=green -16| "▌ 1: alpha " +14| "▌ 1: alpha " style 0-0 fg=green -17| "▌ " +15| "▌ " style 0-0 fg=green -18| "▌ (End of file - total 1 lines) " +16| "▌ (End of file - total 1 lines) " style 0-0 fg=green -19| "▌ " +17| "▌ " style 0-0 fg=green +18| "▌ " + style 0-0 fg=green +19| 20| "▌ " style 0-0 fg=green -21| -22| "▌ " - style 0-0 fg=green -23| "▌ ✓ Read b.txt " +21| "▌ ✓ Read b.txt " style 0-0 fg=green style 2-2 fg=green bold style 3-13 bold -24| "▌ /workspace/project/b.txt " +22| "▌ /workspace/project/b.txt " style 0-0 fg=green -25| "▌ file " +23| "▌ file " style 0-0 fg=green -26| "▌ " +24| "▌ " style 0-0 fg=green -27| "▌ 1: beta " +25| "▌ 1: beta " style 0-0 fg=green -28| "▌ " +26| "▌ " style 0-0 fg=green -29| "▌ (End of file - total 1 lines) " +27| "▌ (End of file - total 1 lines) " style 0-0 fg=green -30| "▌ " +28| "▌ " style 0-0 fg=green -31| "▌ " +29| "▌ " style 0-0 fg=green -32| -33| " Assistant " +30| +31| " Assistant " style 1-9 fg=bright-magenta bold -34| " DONE " +32| " DONE " +33| "────────────────────────────────────────────────────────────────────────────────────────────────────" + style 0-99 dim +34| " " + style 1-1 inverse 35| "────────────────────────────────────────────────────────────────────────────────────────────────────" style 0-99 dim -36| " " - style 1-1 inverse -37| "────────────────────────────────────────────────────────────────────────────────────────────────────" - style 0-99 dim -38| "/tmp/dsh-tui-snapshot-parallel-fi ↑20 ↓6 3% context tools:compact deepseek-v4-flash(reasoning:on)" - style 0-32 dim - style 42-99 dim +36| "deepseek-v4-flash /workspace/project ↑20 ↓6 cache 0% tools:collaps" + style 0-84 dim + style 87-99 dim diff --git a/examples/tui-agent/tests/snapshots/todo-plan/terminal.expected.txt b/examples/tui-agent/tests/snapshots/todo-plan/terminal.expected.txt index 95774b4bfb..9022f28170 100644 --- a/examples/tui-agent/tests/snapshots/todo-plan/terminal.expected.txt +++ b/examples/tui-agent/tests/snapshots/todo-plan/terminal.expected.txt @@ -1,81 +1,72 @@ terminal 100x36 buffer=normal length=36 base=0 viewport=0 lifecycle started=1 stopped=0 progress=inactive -title "Use the todo_write tool to — DSH TUI snapshot" -cursor hidden column=1 viewportRow=33 bufferRow=33 +title "DSH TUI snapshot" +cursor hidden column=1 viewportRow=31 bufferRow=31 buffer -0| "╭──────────────────────────────────────────────────────────────────────────────────────────────────╮" - style 0-99 fg=bright-blue -1| "│ DEEPSEEK HARNESS │" +0| " DEEPSEEK HARNESS" + style 1-8 fg=bright-blue bold + style 10-16 bold +1| " Recorded replay: todo-plan" + style 1-26 fg=bright-black +2| " deepseek-v4-flash • main-session" + style 1-34 dim +3| +4| "▌ " style 0-0 fg=bright-blue - style 2-9 fg=bright-blue bold - style 11-17 bold - style 99-99 fg=bright-blue -2| "│ Use the todo_write tool to │" - style 0-0 fg=bright-blue - style 2-27 fg=bright-black - style 99-99 fg=bright-blue -3| "│ deepseek-v4-flash • main-session │" - style 0-0 fg=bright-blue - style 2-35 dim - style 99-99 fg=bright-blue -4| "╰──────────────────────────────────────────────────────────────────────────────────────────────────╯" - style 0-99 fg=bright-blue -5| -6| "▌ " - style 0-0 fg=bright-blue -7| "▌ You " +5| "▌ You " style 0-0 fg=bright-blue style 2-4 fg=bright-blue bold -8| "▌ Use the todo_write tool to record a plan with exactly three todos: \"read the code\" (in_progress), " +6| "▌ Use the todo_write tool to record a plan with exactly three todos: \"read the code\" (in_progress), " style 0-0 fg=bright-blue -9| "▌ \"write the fix\" (pending), \"run the tests\" (pending). Send all three in one todo_write call. Then " +7| "▌ \"write the fix\" (pending), \"run the tests\" (pending). Send all three in one todo_write call. Then " style 0-0 fg=bright-blue -10| "▌ reply with the single word DONE and stop. " +8| "▌ reply with the single word DONE and stop. " style 0-0 fg=bright-blue -11| "▌ " +9| "▌ " style 0-0 fg=bright-blue -12| -13| " Reasoning " +10| +11| " Reasoning " style 1-9 fg=bright-black italic -14| " The user wants me to use the todo_write tool to record a plan with exactly three todos in the " +12| " The user wants me to use the todo_write tool to record a plan with exactly three todos in the " style 1-99 fg=bright-black italic -15| " specified statuses, then reply with \"DONE\". " +13| " specified statuses, then reply with \"DONE\". " style 1-43 fg=bright-black italic -16| -17| "▌ " +14| +15| "▌ " style 0-0 fg=green -18| "▌ ✓ Update todo list " +16| "▌ ✓ Update todo list " style 0-0 fg=green style 2-2 fg=green bold style 3-19 bold -19| "▌ Updated todo list: 2 pending, 1 in progress, 0 completed. " +17| "▌ Updated todo list: 2 pending, 1 in progress, 0 completed. " style 0-0 fg=green -20| "▌ " +18| "▌ " style 0-0 fg=green -21| -22| " Reasoning " +19| +20| " Reasoning " style 1-9 fg=bright-black italic -23| " The todos have been written successfully. Now I just need to reply with the single word \"DONE\". " +21| " The todos have been written successfully. Now I just need to reply with the single word \"DONE\". " style 1-95 fg=bright-black italic -24| -25| " Assistant " +22| +23| " Assistant " style 1-9 fg=bright-magenta bold -26| " DONE " -27| -28| "Plan" +24| " DONE " +25| +26| "Plan" style 0-3 fg=bright-blue bold -29| " ● read the code" +27| " ● read the code" style 2-2 fg=yellow -30| " ○ write the fix" +28| " ○ write the fix" style 2-2 dim -31| " ○ run the tests" +29| " ○ run the tests" style 2-2 dim +30| "────────────────────────────────────────────────────────────────────────────────────────────────────" + style 0-99 dim +31| " " + style 1-1 inverse 32| "────────────────────────────────────────────────────────────────────────────────────────────────────" style 0-99 dim -33| " " - style 1-1 inverse -34| "────────────────────────────────────────────────────────────────────────────────────────────────────" - style 0-99 dim -35| "/tmp/dsh-tui-snapshot-todo-pl ↑3.1k ↓145 3% context tools:compact deepseek-v4-flash(reasoning:on)" - style 0-28 dim - style 42-99 dim +33| "deepseek-v4-flash /workspace/project ↑3.1k ↓145 cache 47% tools:collapsed" + style 0-79 dim + style 85-99 dim +34-35| diff --git a/packages/ui/tui/tests/harness.ts b/packages/ui/tui/tests/harness.ts index 1109895c3b..a8641ded63 100644 --- a/packages/ui/tui/tests/harness.ts +++ b/packages/ui/tui/tests/harness.ts @@ -24,6 +24,8 @@ interface FakeAgent extends Agent { export interface TuiHarnessOptions { status?: AgentStatus config?: Config + /** Omit the harness's default `welcome`, exercising the banner sweep-reveal path. */ + omitWelcome?: boolean tools?: Record configureContext?: (ctx: Context) => Promise beforeMount?: (session: Session) => void @@ -142,7 +144,7 @@ export async function createTuiTestHarness