@best-agent/cli-darwin-arm64 0.0.3-beta.36 → 0.0.3-beta.38

package/README.md

@@ -31,6 +31,37 @@ best-agent --version | -version | -v | version
 `b8` 是同一入口的短别名（`b` + 省略的 8 个字母）：安装该包后 `b8 <subcommand>` 与
 `best-agent <subcommand>` 等价，帮助文本中的命令名仍为 `best-agent`。
 
+## TUI shell mode（`!`）
+
+`best-agent chat`（`pnpm chat`）的 composer 上，在**空输入**时键入 `!` 进入 shell mode：一次提交只在本地执行一条你键入的命令，
+其输出尾与结算事实（exit / signal / 启动错误）显示在 composer 上方的 chrome block 里，不会打断这次会话的对话。首页（home）的
+输入框同样支持（同一套键位、同一个命令记录）：block 出现在输入框正上方，确认命令后输入框仍持有焦点。
+
+| 动作 | 键 | 行为 |
+| --- | --- | --- |
+| 进入 | 空 composer 上键入 `!` | 消耗该字符：边框变 shell 风格，placeholder 变为 `Run a shell command…`，block 出现 `!  shell mode` 与 `esc exit` |
+| 执行 | `Enter` | 在当前 thread 的 cwd 下恰好执行该行一次；表头 `… · running <t>s`，输出尾最多 8 行（超出显示 `… N earlier lines`）实时刷新 |
+| 停止 | `Esc`（有命令在运行） | 对该命令的进程组投递一次 `SIGTERM`，1 秒后 `SIGKILL`；结算按真实事实呈现（`exit <n>` / `signal <SIG>`） |
+| 退出 | `Esc`（composer 为空、无运行中的命令） | 退出 shell mode，边框/占位/提示复位；之后 `Enter` 就是普通 chat 提交（走模型） |
+| 退出（命令继续） | `Backspace` / `Ctrl+U`（composer 为空） | 同样退出模式；若此时有命令在运行，它不会被停止，block 继续显示到它自己结算 |
+| 取回 | `↑` | 按最近优先取回本进程已执行的命令；不读写 chat 的输入历史 |
+
+- 只在普通 chat 输入状态下接管键盘：ask_user 卡片、待答 interaction、goal draft 与 continuation 对话框保持各自语义。
+  `Esc` 的层序是「in-flight fork → 对话框 / inspect 页 → 运行中的命令（stop）→ 空的 shell composer（退出）→ Run interrupt / exit-confirm」。
+- shell mode 下 `/theme` 之类的 `/`-前缀行是命令文本，不会被解析成本地 slash 命令。
+- cwd 是当前 thread 的工作目录；目录不存在、或命令超过 8,192 bytes 时提交被拒绝（既有 toast 说明原因，composer 文本保留）。
+- 环境：命令由你的 shell 以**交互式登录**方式执行（POSIX 为 `$SHELL -ilc <命令>`，`SHELL` 为空时用 `/bin/sh`；Windows 为
+  `cmd.exe /d /s /c <命令>`）。子进程继承启动这次 TUI 的终端的全部环境变量，shell 再读你的登录文件与 **rc 文件**——因此
+  `.zshrc` / `.bashrc` 里定义的 **alias 与函数（例如 `gp`、`gpl`）和只在那里赋值的变量都可用**，与你在新开终端里执行一致。
+- 代价（已声明）：每条命令都会执行一次 rc 文件，所以 rc 自己写到 stderr 的输出（例如 npm 的 warning）会如实出现在 block 里，
+  且重 rc（oh-my-zsh 之类）会让每条命令多花约 1 秒启动时间；这些都不做静默过滤，因为 block 是读取端的忠实副本。
+- 仍不支持：需要 **TTY** 的交互式程序——`vim`、`top`、需要密码的 `sudo` / `ssh`、以及靠方向键选择的交互式命令（例如
+  `fzf`、某些 `pnpm run` 选择器、你自己的 `prun`）。子进程的 stdin/stdout 是管道而不是终端（`[ -t 1 ]` 为假、没有 raw mode、
+  没有光标寻址），所以这类程序要么直接报 "not a tty"，要么只输出纯文本帧；把终端真正交给子进程（PTY 归属与交接）是独立切片。
+- 边界：命令、输出、退出码与 `↑` 历史只存在于本进程内存，不进入 transcript、compact、模型请求、session 历史或任何 KernelInput，
+  也不创建 Run；想把结果交给模型，需要自己在 chat 里重述（属独立切片）。
+- 运行中的命令在你离开 chat 页面后继续运行，回到 chat 时以运行态恢复显示；离开期间结算的命令以结算态显示，不自动重放。
+
 ## 安装与发布
 
 - `npm install -g @best-agent/cli@beta`：安装当前平台的 CLI 包；

package/bin/best-agent

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/bin/best-agent
-size: 139010656 bytes
-sha256: 2d802ff9ac344eb206a8ae3c53742d99c9c77c06788e08fc1e79b90d623f3141
+size: 139224064 bytes
+sha256: e095dacd1c0905c80c64ad9019d5b8835ff88b48b60cfb136548fb846fdc9196

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@best-agent/cli-darwin-arm64",
-  "version": "0.0.3-beta.36",
+  "version": "0.0.3-beta.38",
   "description": "best-agent CLI native executable for darwin-arm64",
   "os": [
     "darwin"
@@ -9,10 +9,12 @@
     "arm64"
   ],
   "bin": {
-    "best-agent-darwin-arm64": "./bin/best-agent"
+    "best-agent-darwin-arm64": "./bin/best-agent",
+    "best-agent-cpu-supervisor-darwin-arm64": "./bin/cpu-supervisor"
   },
   "files": [
     "bin/best-agent",
+    "bin/cpu-supervisor",
     "README.md",
     "LICENSE"
   ],