@jun133/kitty 0.0.10 → 0.0.12

package/README.md

@@ -1,5 +1,7 @@
 # 小猫智能体 Kitty
 
+![demo](site/images/product.png)
+
 官网：https://agentjz.github.io/kitty/
 
 <p align="center">
@@ -14,20 +16,23 @@
   <img alt="agent" src="https://img.shields.io/badge/mode-agent-7c3aed">
 </p>
 
-小猫智能体是给本地代码仓库使用的 agent harness。
-
-它把模型、工具、上下文、会话、变更记录和验证事实收进一个稳定的本地编程体验里，让长任务可以被推进、保存、恢复和继续。
-
-它的主线不是自我改造，而是把本地 coding agent 做成可恢复、可验收、省钱的执行系统：
-
-- 本地执行内核：聊天只是入口，session、workset、execution、events、memory 和 status 才是任务现场。
-- 生产现场：`kitty status` 把当前目标、下一步、阻塞、后台、成本、恢复、skill 和 memory 汇成一眼可读的现场。
-- Cost Kernel：即使只用一个模型，也通过稳定前缀、易变尾部、大内容压缩、按需 skill 和 cache usage 审阅来省 token。
-- 产品级验收合同：`kitty eval` 验证真实用户路径，而不是只证明模块能 import。
-
-## ✨ 为什么是小猫智能体
-
-小猫智能体的核心体验很明确：
+![demo](site/images/demo.png)
+
+
+小猫智能体是给本地代码仓库使用的 agent harness。
+
+它把模型、工具、上下文、会话、变更记录和验证事实收进一个稳定的本地编程体验里，让长任务可以被推进、保存、恢复和继续。
+
+它的主线不是自我改造，而是把本地 coding agent 做成可恢复、可验收、省钱的执行系统：
+
+- 本地执行内核：聊天只是入口，session、workset、execution、events、memory 和 status 才是任务现场。
+- 生产现场：`kitty status` 把当前目标、下一步、阻塞、后台、成本、恢复、skill 和 memory 汇成一眼可读的现场。
+- Cost Kernel：即使只用一个模型，也通过稳定前缀、易变尾部、工具输出治理、按需 skill 和 cache usage 审阅来省 token。
+- 产品级验收合同：`kitty eval` 验证真实用户路径，而不是只证明模块能 import。
+
+## ✨ 为什么是小猫智能体
+
+小猫智能体的核心体验很明确：
 
 - 🧭 一个 agent 主循环负责推进任务。
 - 🛠️ 四个 core 工具完成基础编程闭环。
@@ -42,17 +47,17 @@
 | 🧭 Agent 循环 | 模型、工具、session、收尾都在同一个主循环里推进 |
 | 🧠 Context | 近场可见对话、项目上下文、项目地图、运行时上下文、工作记忆、工作集、长上下文压缩和预算报告 |
 | 💾 Session | 会话记录、checkpoint、todo、工作集、恢复现场、结构化可审阅 memory assets |
-| 🗺️ Project Map | 目录、入口、脚本、测试、仓库文档和 git 事实进入短项目地图 |
-| 🔌 Provider | OpenAI-compatible provider、请求恢复、连接诊断 |
-| ❄️ Cost Kernel | 稳定前缀和易变尾部分离，大输出压缩，skill 默认只给索引，读取 provider usage 里的 cache hit / miss / read / write，status 显示稳定比例和最近请求命中状态 |
-| 🛠️ Core tools | `read`、`edit`、`write`、`bash` |
-| 🧩 Extensions | `todo`、`worktree`、`network`、`background`、`subagent`、`skills` |
-| 🧾 Control plane | SQLite 账本记录 task lifecycle、execution、deadline、输出健康、wait policy、pid、状态和 wake 事实；host 负责等待和恢复 lead |
-| 🧯 Production scene | `status` 把 session、background、subagent、memory、skills、cache、wake 和失败边界投影成当前现场、下一步和阻塞原因 |
-| 📋 Plan 工作流 | `plan.md` 是当前任务总管，配合 plan skill 管理需求、事实、失败测试、目标、设计、任务、验证和收口 |
+| 🗺️ Project Map | 目录、入口、脚本、测试、仓库文档和 git 事实进入短项目地图 |
+| 🔌 Provider | OpenAI-compatible provider、请求恢复、连接诊断 |
+| ❄️ Cost Kernel | 稳定前缀和易变尾部分离，Tool Output Kernel 保存原始输出并给模型短证据，skill 默认只给索引，读取 provider usage 里的 cache hit / miss / read / write，status 显示稳定比例、工具输出节省和最近请求命中状态 |
+| 🛠️ Core tools | `read`、`edit`、`write`、`bash` |
+| 🧩 Extensions | `todo`、`worktree`、`network`、`background`、`subagent`、`skills` |
+| 🧾 Control plane | SQLite 账本记录 task lifecycle、execution、deadline、输出健康、wait policy、pid、状态和 wake 事实；host 负责等待和恢复 lead |
+| 🧯 Production scene | `status` 把 session、background、subagent、memory、skills、cache、wake 和失败边界投影成当前现场、下一步和阻塞原因 |
+| 📋 Plan 工作流 | `plan.md` 是当前任务总管，配合 plan skill 管理需求、事实、失败测试、目标、设计、任务、验证和收口 |
 | 💬 产品面 | CLI、交互终端、Telegram 私聊服务 |
 | 📎 证据记录 | session events、终端日志、崩溃记录、文件变更记录 |
-| 🧪 Evaluation | `kitty eval` 暴露产品验收场景，`--run` 会跑本地可验证检查闭环 |
+| 🧪 Evaluation | `kitty eval` 暴露产品验收场景，`--run` 会跑本地可验证检查闭环 |
 
 ## ⚡ 快速开始
 
@@ -69,68 +74,68 @@ npm.cmd run build
 kitty init
 ```
 
-启动交互式 agent：
-
-```bash
-kitty
-```
+启动交互式 agent：
 
-如果已有会话，`kitty` 会先显示最近会话列表：输入 `1` 继续最近会话，输入 `0` 新建会话。没有历史会话时会直接新建。会话标题由模型在第一次真实对话完成后生成，后续保持稳定。
-
-启动 Ink TUI：
-
-```bash
-kitty tui
-node dist/cli.js tui
-```
-
-TUI 是可替换的终端壳层，复用同一套 session、driver、工具和斜杠命令。主区显示用户输入、thinking 和回复；工具、后台任务、subagent 和上下文占用在底部现场区呈现，不灌进主对话区。按键：`Enter` 发送，`Ctrl+J` 换行，`PageUp` / `PageDown` 滚动，`Home` / `End` 跳到顶部 / 底部，鼠标滚轮滚动，`Ctrl+C` 中断当前轮。
-
-交互模式支持本地斜杠命令。斜杠命令直接读取本地现场，不发送给模型：
-
-| 斜杠命令 | 用途 |
-| --- | --- |
-| `/help` | 查看当前可用斜杠命令 |
-| `/status` | 查看当前项目现场 |
-| `/background`、`/bg` | 查看后台任务现场 |
-| `/memory` | 查看 runtime memory assets |
-| `/skills` | 查看 runtime skills 健康状态 |
-| `/events` | 查看当前 session 最近事件 |
-| `/doctor` | 运行本地配置 preflight |
-| `/sessions` | 查看最近会话 |
-| `/session` | 查看当前 session id |
-| `/copy` | 打印当前 session 对话文本 |
-| `/export` | 打印当前 session JSON 快照 |
-| `/clear` | 清空 UI shell 的当前输入语义 |
-| `/reset` | 清空当前项目运行状态并退出 |
-| `/exit`、`quit`、`q` | 退出当前会话 |
-
-执行一次明确任务：
+```bash
+kitty
+```
+
+如果已有会话，`kitty` 会先显示最近会话列表：输入 `1` 继续最近会话，输入 `0` 新建会话。没有历史会话时会直接新建。会话标题由模型在第一次真实对话完成后生成，后续保持稳定。
+
+启动 Ink TUI：
+
+```bash
+kitty tui
+node dist/cli.js tui
+```
+
+TUI 是可替换的终端壳层，复用同一套 session、driver、工具和斜杠命令。主区显示用户输入、thinking 和回复；工具、后台任务、subagent 和上下文占用在底部现场区呈现，不灌进主对话区。按键：`Enter` 发送，`Ctrl+J` 换行，`PageUp` / `PageDown` 滚动，`Home` / `End` 跳到顶部 / 底部，鼠标滚轮滚动，`Ctrl+C` 中断当前轮。
+
+交互模式支持本地斜杠命令。斜杠命令直接读取本地现场，不发送给模型：
+
+| 斜杠命令 | 用途 |
+| --- | --- |
+| `/help` | 查看当前可用斜杠命令 |
+| `/status` | 查看当前项目现场 |
+| `/background`、`/bg` | 查看后台任务现场 |
+| `/memory` | 查看 runtime memory assets |
+| `/skills` | 查看 runtime skills 健康状态 |
+| `/events` | 查看当前 session 最近事件 |
+| `/doctor` | 运行本地配置 preflight |
+| `/sessions` | 查看最近会话 |
+| `/session` | 查看当前 session id |
+| `/copy` | 打印当前 session 对话文本 |
+| `/export` | 打印当前 session JSON 快照 |
+| `/clear` | 清空 UI shell 的当前输入语义 |
+| `/reset` | 清空当前项目运行状态并退出 |
+| `/exit`、`quit`、`q` | 退出当前会话 |
+
+执行一次明确任务：
 
 ```bash
 kitty "检查这个仓库并修复失败测试"
 ```
 
-## ⌨️ 常用命令
+## ⌨️ 常用命令
 
 | 命令 | 用途 |
 | --- | --- |
-| `kitty` | 进入默认 agent 交互；有历史会话时先选择继续或新建，也可直接接收一次性 prompt |
-| `kitty agent` | 显式进入 agent 模式 |
-| `kitty tui` | 进入 Ink 终端工作台，支持主区滚动、底部输入和运行现场 |
-| `kitty background` | 查看后台任务；`wait <id>` 等待任务；`stop <id>` 停止任务 |
-| `kitty resume [sessionId]` | 恢复最近会话或指定会话 |
+| `kitty` | 进入默认 agent 交互；有历史会话时先选择继续或新建，也可直接接收一次性 prompt |
+| `kitty agent` | 显式进入 agent 模式 |
+| `kitty tui` | 进入 Ink 终端工作台，支持主区滚动、底部输入和运行现场 |
+| `kitty background` | 查看后台任务；`wait <id>` 等待任务；`stop <id>` 停止任务 |
+| `kitty resume [sessionId]` | 恢复最近会话或指定会话 |
 | `kitty sessions` | 查看最近会话 |
 | `kitty events [sessionId]` | 查看最近会话或指定会话的机器事件 |
 | `kitty config show` | 查看从 `.kitty/.env` 解析出的当前运行配置 |
 | `kitty config path` | 查看当前项目 `.kitty/.env` 路径 |
-| `kitty status` | 查看当前项目现场：当前目标、下一步、阻塞、后台、恢复、成本、session、context budget、memory、skills、project map、execution、wake |
-| `kitty memory` | 创建、查看、读取、搜索、删除 runtime memory assets，或把 memory 沉淀到 skill references |
+| `kitty status` | 查看当前项目现场：当前目标、下一步、阻塞、后台、恢复、成本、session、context budget、memory、skills、project map、execution、wake |
+| `kitty memory` | 创建、查看、读取、搜索、删除 runtime memory assets，或把 memory 沉淀到 skill references |
 | `kitty changes` | 查看记录的文件变更 |
 | `kitty undo [changeId]` | 撤销最近一次或指定变更 |
 | `kitty diff [path]` | 查看当前 git diff |
 | `kitty doctor` | 检查 `.kitty` 文件、env contract、provider preset、runtime、provider 连接和下一步 |
-| `kitty eval` | 查看产品验收场景；`kitty eval --run` 运行本地机器验收 |
+| `kitty eval` | 查看产品验收场景；`kitty eval --run` 运行本地机器验收 |
 | `kitty telegram serve` | 启动 Telegram 私聊服务 |
 
 ## 🛠️ 工具体系
@@ -151,27 +156,27 @@ Extension 是可启用、可禁用、独立存在的工具集合：
 | `todo` | 会话级 todo 写入和可见 checklist |
 | `worktree` | Git worktree 事实、创建、保留和删除 |
 | `network` | HTTP session、请求、探测、下载、trace、OpenAPI 检查 |
-| `background` | 后台命令执行、运行输出摘要、deadline、last output、检查、等待、停止和生命周期记录 |
-| `subagent` | 聚焦子执行启动、派工边界、deadline、状态检查、worker 结论回传、wait policy、lead 挂起与 wake 恢复 |
-| `skills` | 项目运行时 skill 包索引、正文加载、资源读取和脚本运行；使用事实进入 observability 和 task lifecycle |
-
-默认 agent 会启用 `todo`、`worktree`、`network`、`background`、`subagent`、`skills`。
+| `background` | 后台命令执行、运行输出摘要、deadline、last output、检查、等待、停止和生命周期记录 |
+| `subagent` | 聚焦子执行启动、派工边界、deadline、状态检查、worker 结论回传、wait policy、lead 挂起与 wake 恢复 |
+| `skills` | 项目运行时 skill 包索引、正文加载、资源读取和脚本运行；使用事实进入 observability 和 task lifecycle |
+
+默认 agent 会启用 `todo`、`worktree`、`network`、`background`、`subagent`、`skills`。
 
 Runtime skills 放在项目 `SKILL.md`、`.skills/**/SKILL.md` 或 `skills/**/SKILL.md`。默认上下文只显示 skill 名称、说明、路径、健康状态和资源索引；完整正文必须由模型明确调用 `skill_load` 后进入当前轮。Skill 包内的 `references/`、`scripts/`、`examples/` 和 `assets/` 会作为资源分组出现，需要时用 `skill_read_resource` 读取资源，或用 `skill_run_script` 运行已声明的 `scripts/` 资源。Skill frontmatter 可用 `requires` 声明命令依赖，运行时用 `skill_check` 检查包健康和依赖可用性。`.codex/skills/**` 是 Codex 维护本仓库用的开发规范，不属于小猫运行时 skill。
 
-当前仓库内置四个开发阶段 runtime skill：`research`、`plan`、`do`、`verification`。其中 `plan` 强制把 `plan.md` 写成单文件规格驱动执行合同：需求文档、当前事实、失败测试、目标、不做范围、设计、实施任务、验证计划和收口记录都在一个文件里闭环。
+当前仓库内置四个开发阶段 runtime skill：`research`、`plan`、`do`、`verification`。其中 `plan` 强制把 `plan.md` 写成单文件规格驱动执行合同：需求文档、当前事实、失败测试、目标、不做范围、设计、实施任务、验证计划和收口记录都在一个文件里闭环。
 
-Provider 请求优先携带同 session 的近场可见对话。短会话不靠账本拼上下文；长会话超预算时摘要旧对话，保留最近对话 tail。Session memory 由模型在 turn 收口时按固定 Markdown 区块写出：`Current Focus`、`User Constraints`、`Decisions`、`Open Threads`、`Verification Facts`、`Reusable Lessons`。机器只维护格式和保存边界，不替模型判断事实重要性。
-
-Cost Kernel 的边界很硬：省钱不靠模型路由，不靠把能力关掉，而靠上下文结构。稳定内容放在前缀，易变事实放在尾部；大段工具输出和旧历史进入压缩摘要或证据资产；skill 正文、resources、examples 不默认注入，模型需要时再加载。
-
-Provider usage 会归一化缓存事实：DeepSeek 的 `prompt_cache_hit_tokens` / `prompt_cache_miss_tokens`，OpenAI 的 `prompt_tokens_details.cached_tokens`，Anthropic 的 `cache_read_input_tokens` / `cache_creation_input_tokens`，以及 Gemini cached content tokens。`model.request` observability 事件会记录这些字段，`kitty status` 会显示最近模型请求的缓存命中和 context cache layout。OpenAI 请求会使用同 session 稳定 `prompt_cache_key`；DeepSeek 不写无效 `cache_control`，优先保持稳定前缀和命中观测。
-
-`kitty eval` 是产品验收合同：每个场景都说明用户路径和机器证据。`kitty eval --run` 包含生产现场、恢复演练、远程入口、cache economy、skill/memory readiness 和失败边界检查。usage 字段解析、provider cache policy、stable prefix fingerprint、volatile tail、skill index boundary 和大输出压缩都必须能机器验证。真实省钱仍取决于 provider 是否返回 usage，以及同一 session 的前缀是否真的被上游缓存命中。
+Provider 请求优先携带同 session 的近场可见对话。短会话不靠账本拼上下文；长会话超预算时摘要旧对话，保留最近对话 tail。Session memory 由模型在 turn 收口时按固定 Markdown 区块写出：`Current Focus`、`User Constraints`、`Decisions`、`Open Threads`、`Verification Facts`、`Reusable Lessons`。机器只维护格式和保存边界，不替模型判断事实重要性。
+
+Cost Kernel 的边界很硬：省钱不靠模型路由，不靠把能力关掉，而靠上下文结构。稳定内容放在前缀，易变事实放在尾部；Tool Output Kernel 把原始工具输出保存成可恢复证据，把测试、构建、typecheck、搜索和 git diff 输出投影成短证据，再记录估算节省；skill 正文、resources、examples 不默认注入，模型需要时再加载。
 
-Session workset 记录当前会话实际读过和改过的文件。`read` 成功后记录读取事实，`edit` / `write` 成功后记录变更事实和 change id。工作集会进入 session、working memory 和 `kitty status`，让用户看到当前任务真正碰过哪些文件。
+Provider usage 会归一化缓存事实：DeepSeek 的 `prompt_cache_hit_tokens` / `prompt_cache_miss_tokens`，OpenAI 的 `prompt_tokens_details.cached_tokens`，Anthropic 的 `cache_read_input_tokens` / `cache_creation_input_tokens`，以及 Gemini cached content tokens。`model.request` observability 事件会记录这些字段，`tool.output` observability 事件会记录工具输出原始 token 估算、投影 token 估算、节省比例、是否截断和完整输出路径。`kitty status` 会显示最近模型请求的缓存命中、context cache layout 和工具输出治理现场。OpenAI 请求会使用同 session 稳定 `prompt_cache_key`；DeepSeek 不写无效 `cache_control`，优先保持稳定前缀和命中观测。
+
+`kitty eval` 是产品验收合同：每个场景都说明用户路径和机器证据。`kitty eval --run` 包含生产现场、恢复演练、远程入口、cache economy、skill/memory readiness 和失败边界检查。usage 字段解析、provider cache policy、stable prefix fingerprint、volatile tail、skill index boundary 和大输出压缩都必须能机器验证。真实省钱仍取决于 provider 是否返回 usage，以及同一 session 的前缀是否真的被上游缓存命中。
+
+Session workset 记录当前会话实际读过和改过的文件。`read` 成功后记录读取事实，`edit` / `write` 成功后记录变更事实和 change id。工作集会进入 session、working memory 和 `kitty status`，让用户看到当前任务真正碰过哪些文件。
 
-Memory assets 分为 `session`、`project`、`user` 和 `evidence`。每条 asset 暴露 kind、id、title、scope、tags、路径和 evidence references。Session memory 由模型写，project/user/evidence assets 通过 `kitty memory --create <kind> --title <title> --content <content>` 创建成可审阅 Markdown 资产。`kitty memory -q <query>` 做多词候选召回，只返回命中的资产和证据行，不替模型判断语义重要性。`kitty memory <memoryId> --append-to-skill <skillName>` 可以写入该 skill 的 `references/`。这条路径只沉淀已保存事实，不替模型判断哪些经验值得复用。
+Memory assets 分为 `session`、`project`、`user` 和 `evidence`。每条 asset 暴露 kind、id、title、scope、tags、路径和 evidence references。Session memory 由模型写，project/user/evidence assets 通过 `kitty memory --create <kind> --title <title> --content <content>` 创建成可审阅 Markdown 资产。`kitty memory -q <query>` 做多词候选召回，只返回命中的资产和证据行，不替模型判断语义重要性。`kitty memory <memoryId> --append-to-skill <skillName>` 可以写入该 skill 的 `references/`。这条路径只沉淀已保存事实，不替模型判断哪些经验值得复用。
 
 查看配置：
 
@@ -213,11 +218,11 @@ kitty config show
 | Provider / Config | `src/provider/`, `src/config/` |
 | Core tools | `src/tools/` |
 | Extensions | `src/extensions/` |
-| Runtime skills | `src/skills/`, `skills/` |
-| Project map | `src/project/map.ts` |
-| Memory assets | `.kitty/memory/sessions/`, `.kitty/memory/project/`, `.kitty/memory/user/`, `.kitty/memory/evidence/` |
-| Control plane | `src/control/`, `src/execution/` |
-| Host 边界 | `src/host/` |
+| Runtime skills | `src/skills/`, `skills/` |
+| Project map | `src/project/map.ts` |
+| Memory assets | `.kitty/memory/sessions/`, `.kitty/memory/project/`, `.kitty/memory/user/`, `.kitty/memory/evidence/` |
+| Control plane | `src/control/`, `src/execution/` |
+| Host 边界 | `src/host/` |
 | Session events | `.kitty/events/`, `src/session/events.ts` |
 | CLI / Shell / Telegram | `src/cli/`, `src/shell/`, `src/telegram/` |
 | Runtime UI | `src/runtime-ui/` |
@@ -225,7 +230,7 @@ kitty config show
 | Evaluation | `src/evaluation/`, `tests/evaluation/` |
 | 产品宣传页 | `site/` |
 | GitHub Pages 发布 | `.github/workflows/pages.yml` |
-| 项目文档 | `spec/` |
+| 项目文档 | `spec/` |
 | Tests | `tests/` |
 
 ## 🧪 开发
@@ -255,5 +260,5 @@ npm.cmd run verify
 - `spec/用户审阅/宪法原则/`
 - `spec/技术实现/`
 
-项目文档、代码和测试共同描述同一个当前现实。项目入口、配置、文档和测试都跟随当前实现同步维护。
+项目文档、代码和测试共同描述同一个当前现实。项目入口、配置、文档和测试都跟随当前实现同步维护。
 

package/dist/{App-6FETP3LH.mjs → App-V6SLDWQH.mjs}

@@ -2,7 +2,7 @@ import {
   TRANSCRIPT_OUTER_PADDING_X,
   TUI_COLORS,
   renderTranscriptLineViews
-} from "./chunk-DFDOKON5.mjs";
+} from "./chunk-4HIVDFN5.mjs";
 
 // src/shell/tui/layout.ts
 var TUI_MIN_WIDTH = 48;
@@ -385,7 +385,7 @@ function readFactColor(value) {
 function createTranscriptComponent(kit) {
   const { React, Box, Text } = kit;
   return function Transcript(props) {
-    const rows = renderTranscriptLineViews(props.state.transcript, props.viewport.width).slice(props.state.scroll.offset, props.state.scroll.offset + props.viewport.height);
+    const rows = props.controller ? props.controller.getVisibleTranscriptLineViews(props.viewport) : renderTranscriptLineViews(props.state.transcript, props.viewport.width).slice(props.state.scroll.offset, props.state.scroll.offset + props.viewport.height);
     return React.createElement(
       Box,
       {
@@ -425,16 +425,50 @@ function renderTranscriptLine(React, Box, Text, row) {
         Text,
         { color: row.style.text, wrap: "truncate-end" },
         React.createElement(Text, { color: TUI_COLORS.thought, italic: row.style.italicPrefix, wrap: "truncate-end" }, row.prefix),
-        row.text
+        ...renderTranscriptSpans(React, Text, row)
       ) : React.createElement(Text, {
         color: row.style.text,
         bold: row.style.bold,
         dimColor: row.style.dim,
         wrap: "truncate-end"
-      }, row.text)
+      }, ...renderTranscriptSpans(React, Text, row))
     )
   );
 }
+function renderTranscriptSpans(React, Text, row) {
+  const spans = row.spans.length > 0 ? row.spans : [createPlainSpan(row.text)];
+  return spans.map((span, index) => React.createElement(Text, {
+    key: `${row.id}-span-${index}`,
+    color: readSpanColor(row, span),
+    backgroundColor: span.code ? TUI_COLORS.panelStrong : void 0,
+    bold: row.style.bold || span.bold,
+    dimColor: row.style.dim || span.dim,
+    italic: span.italic,
+    strikethrough: span.strike,
+    underline: Boolean(span.href),
+    wrap: "truncate-end"
+  }, span.text));
+}
+function readSpanColor(row, span) {
+  if (span.href) {
+    return TUI_COLORS.warning;
+  }
+  if (span.code) {
+    return TUI_COLORS.system;
+  }
+  return row.style.text;
+}
+function createPlainSpan(text) {
+  return {
+    text,
+    bold: false,
+    italic: false,
+    code: false,
+    dim: false,
+    strike: false,
+    href: void 0
+  };
+}
 
 // src/shell/tui/components/App.ts
 function createTuiAppComponent(kit) {
@@ -483,7 +517,7 @@ function createTuiAppComponent(kit) {
     return React.createElement(
       Box,
       { flexDirection: "column", width, height },
-      React.createElement(Transcript, { state, viewport: transcriptViewport }),
+      React.createElement(Transcript, { controller: props.controller, state, viewport: transcriptViewport }),
       React.createElement(
         Box,
         {