@armadra/agent 0.6.2 → 0.6.4

package/CHANGELOG.md

@@ -5,6 +5,91 @@ English · [简体中文](CHANGELOG.zh-CN.md)
 > This file is in English starting with 0.6.0. Release notes for 0.1 through 0.5.1 are in Chinese in
 > [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md). New entries go into both files.
 
+## 0.6.4 (2026-10-03)
+
+- **Interrupt and send now**: while a run is in progress, Enter still queues the message as a steer (delivered at the next
+  delivery point), and the new `Ctrl+X` (key action `app.message.interrupt`) stops the current turn at once (model stream and
+  running tools; every tool call keeps exactly one result, `aborted by user`) and immediately starts a new turn with the
+  input, queued steers joined in front (`origin: "interrupt"`, `↳ interrupt` in the message area); with an empty input it
+  sends the queued steers now. Esc is unchanged. `ui.enterWhileRunning: "queue" | "interrupt"` (default queue, editable in
+  `/config`) swaps Enter and `Ctrl+X`. The running line shows `Enter queue · Ctrl+X interrupt & send` while the input box has
+  text. The sub-agent view supports the same key: an ama sub-agent stops its turn and starts a new one with the message; an
+  external agent is interrupted when its driver can cancel a single turn (ACP, Claude stream-json, Codex) and otherwise the
+  message is queued with a hint. Line mode accepts `/interrupt <text>`; RPC `prompt` / `steer` and the SDK take
+  `interrupt: true`. The new request keeps the interrupted request as its prefix, so the cache keeps hitting. Docs:
+  docs/tui.md, docs/rpc.md.
+- **Status line split into sides; quota labels fixed**: the `full` layout now keeps state and switches on the left and
+  metrics and the model on the right. The rate line's left side holds `codemode on` (with `net!`) · sandbox · preset ·
+  `→ fallback model` · queue count · host status, and its right side `tps … (avg · ttft) · ↑ ↓ · cache · re-billing · [-]`;
+  the status bar keeps the permission mode and the `shift+tab` hint on the left; the quota line is right-aligned. When
+  narrow, right-side metrics drop before left-side switches; the permission mode, `tps` and `[-]` never drop; the
+  single-line `compact` layout keeps its token order. Quota labels follow the window length: a weekly window sent as
+  primary reads `Weekly` instead of `7d:`, and the 5-hour window comes first; the all-zero "no such window" the server
+  sends is no longer rendered as `0d: 0.0%` (filtered both when parsing and when rendering). Docs: docs/tui.md.
+
+## 0.6.3 (2026-10-03)
+
+- **TUI: `Ctrl+B` moves foreground tasks to the background; background approvals dock in the agent bar**: while the main
+  turn waits for a foreground sub-agent task (or `task_ctl wait`), `Ctrl+B` moves it to the background whatever is in the
+  input box: the tool line turns into `⎿ moved to the background · 12s` with a follow-up status line, the main turn carries
+  on and you can keep chatting, and the task reports back with a `<task-notification>` turn. With nothing to move, `Ctrl+B`
+  still moves the cursor left. The running line shows `Ctrl+B to background`; in tmux press `C-b C-b`. In the agent bar, `b`
+  moves the selected task to the background and `x` stops it (press twice); `/tasks bg [id]` does the same from the command
+  line (line mode too). Esc interrupts only the foreground and says which background tasks keep running. Approvals of
+  background tasks no longer pop up while the main session is busy or the input box has a draft: they dock in the agent bar
+  ("needs approval", running line `↓ handle approval`) and pop up once the main session is idle with an empty input, or
+  when you open that task's view; approvals of the main session and of foreground tasks are unchanged. Docs: docs/tui.md.
+- **Background sub-agents: config, `-p` and RPC**: new `subagents.background: "auto" | "always" | "never"` (default auto:
+  task runs in the background by default in the TUI / RPC / ACP and in the foreground with `-p`; the call argument and the
+  agent type's `background:` take precedence) and `subagents.autoBackgroundAfterMs` (move a foreground task to the background
+  after it has run this long; default 0, off). Both are accepted at project level and editable in `/config`. When background
+  tasks are still running after the main turn, `-p` prints one stderr line and waits for them and their notification turns
+  before printing the result (bounded by `--max-turns` / `--max-cost`, exit 8 at the limit; Ctrl+C still stops); the json
+  result carries `tasks`. RPC adds `background_task { taskId? }` → `{ backgrounded }` and the `subagent_background` event
+  (44 commands), and the SDK `session.backgroundTask(taskId?)`. Docs: docs/agents.md, docs/rpc.md.
+- **Agent bar is reachable again**: `↓` on an empty input is now the only default key into the agent bar and works whenever
+  the session has tasks, even after the bar collapsed (it used to require the bar to be visible). `Ctrl+B` no longer enters
+  the bar (tmux's default prefix swallowed it); it is reserved for moving foreground tasks to the background and still moves
+  the cursor left for now (`"app.agents.focus": ["down", "ctrl+b"]` restores the old key). Pressing `↓` with text in the input
+  box, with `ui.agentBar: "off"` or with no tasks now shows a one-line hint instead of doing nothing silently; `↓` while
+  browsing input history still steps through history. The running line ends with `↓ Agent bar` while the bar has tasks
+  (dropped on narrow terminals). Embedding hosts (with a profile) no longer default to `ui.agentBar: "off"`; a host that does
+  not want the bar sets it in its profile's config file.
+- **Sub-agents run in the background by default; foreground tasks can be moved to the background**: in the TUI, RPC and
+  ACP a `task` without `background` now returns a taskId at once and the result arrives later as a `<task-notification>`;
+  `-p` keeps waiting in the foreground (setting `subagents.background`: `auto` (default) / `always` / `never`; an agent
+  definition's `background:` and the call's own argument still win, and built-in types no longer pin `background: false`).
+  A blocking foreground `task` or `task_ctl wait` can be moved to the background (`session.backgroundTask(taskId?)`, event
+  `subagent_background`): the tool returns a fixed "Moved to the background …; it was not interrupted" result, the task is
+  detached from the parent turn (Esc no longer stops it) and reports with the usual notification;
+  `subagents.autoBackgroundAfterMs` (default 0, off) does the same after a timeout. The `task` description and its one rule
+  were rewritten for the background default (session constants; the tool table differs between the TUI and `-p`).
+
+- **ChatGPT subscription models use the backend's context window**: the context window reported by the ChatGPT backend's
+  model list (codex `context_window`, and siwc entries when they carry it) now takes precedence over models.dev, which lists
+  the API window (1.1M for some models) while the subscription backend accepts less (272k); auto-compaction used to plan for
+  the larger window, so long sessions were rejected past 272k. models.dev still fills fields the backend leaves out (output
+  limit and the like) but no longer overrides input modalities or reasoning efforts the backend reports; when neither has a
+  context window, `chatgpt` models use a conservative 128k instead of turning auto-compaction off. `ama models discover chatgpt`
+  shows the backend window marked "(backend)" and lists models the backend reported none for. Caches written by older
+  versions without windows keep the models.dev value until `ama models discover chatgpt` refreshes them.
+
+- **Status line: subscription quota line and reference colors**: with a ChatGPT subscription model the `full` layout gets a
+  third line below the status bar, `Session: 10.0% | Reset: 2h 18m | Weekly: 31.0% | Weekly Reset: 6d 5h` (from
+  `quota_update`; refreshed once a minute; `5h 10% ↻2h18m · wk 31% ↻6d5h` below 80 columns; the codex flavor shows a
+  placeholder until the first request, siwc without data and non-subscription models show nothing). `compact` only appends a
+  short `5h 10% wk 31%` item at the end, keeping the existing order. The `full` lines are recolored after the reference (dim
+  labels; purple rates, durations and reset times; blue model, thinking level and amounts; green directory and branch; yellow
+  cost; threshold-colored percentages), and the branch shows `↑N` / `↓N` ahead of / behind its upstream. Docs: docs/tui.md
+  "Layout".
+- **Startup header with an AMA logo and a short light-up animation**: the boxed info block is replaced by a 5-row "AMA" logo
+  (block characters, colored letter by letter with the theme's accent → user → tool; a `_ / \ |` version in ASCII mode) with
+  the version, model, directory, mode and key hints beside it (72+ columns) or below it (48–71 columns); below 48 columns a
+  two-line header is shown. On startup a one-off sweep of about a second lights the logo up and settles in place, leaving no
+  frames in the scrollback; any key settles it at once and still reaches the input box. It does not play with
+  `ui.animation: false`, without colors, outside a TTY, in an embedding host, under `CI`, with a command-line prompt or in a
+  short terminal. New `ui.logo: "auto" | "off"` (off shows only the info lines). Docs: docs/en/tui.md "Startup screen".
+
 ## 0.6.2 (2026-10-03)
 
 - **ChatGPT codex sign-in lists models, and the channel follows the sign-in method**: the codex model list

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,65 @@
 
 > 从 0.6.0 起 [CHANGELOG.md](CHANGELOG.md) 为英文，本文件保留中文记录（0.1–0.5.1 的完整历史在此）。新条目两份都要加。
 
+## 0.6.4（2026-10-03）
+
+- **打断并立即发送**：运行中按 Enter 仍是排队插话（等下一个投递点送达），新增 `Ctrl+X`（键位动作 `app.message.interrupt`）立即中止
+  当前回合（模型流与正在跑的工具，每个工具调用仍恰有一个结果 `aborted by user`），并马上以输入框的文字开新回合，已排队的插话拼在
+  前面（会话里 `origin: "interrupt"`，消息区标 `↳ 打断`）；输入为空时把排队的插话立即送出。Esc 语义不变。配置
+  `ui.enterWhileRunning: "queue" | "interrupt"`（缺省 queue，`/config` 可改）互换 Enter 与 `Ctrl+X`。输入框有字时运行提示行显示
+  `Enter 排队 · Ctrl+X 打断并发送`。子 Agent 视图同样可用：ama 子 Agent 中止本轮后立即以这条消息开新一轮；外部 Agent 的驱动能中断
+  单个回合（ACP、Claude stream-json、Codex）时中断后发送，否则退回排队并提示。line 模式认 `/interrupt <文本>`；RPC `prompt` /
+  `steer` 与 SDK 增 `interrupt: true`。新请求以被打断的那次请求为前缀，缓存照常命中。文档：docs/tui.md、docs/rpc.md。
+- **状态栏左右分区与配额标签修正**：`full` 布局改为左列「状态 / 开关」、右列「度量与模型」——速率行左区是 `codemode on`（含
+  `net!`）· 沙箱 · 预设 · `→ 回退模型` · 排队数 · 宿主状态，右区是 `tps … (avg · ttft) · ↑ ↓ · cache · 重计费 · [-]`；状态栏
+  左区仍是权限模式与 `shift+tab` 提示；配额行右对齐。窄屏先丢右区度量、再丢左区开关，权限模式、`tps` 与 `[-]` 不丢；`compact`
+  单行的记号顺序不变。配额标签按窗口时长认：周窗口放在 primary 时显示「本周 / Weekly」而不是 `7d:`，5 小时窗口排在前面；
+  服务端用全 0 表示的空窗口不再渲染成 `0d: 0.0%`（解析与显示两层都过滤）。文档：docs/tui.md。
+
+## 0.6.3（2026-10-03）
+
+- **TUI：`Ctrl+B` 前台任务转后台，后台任务审批停靠在 Agent 栏**：主回合在等前台子 Agent 任务（或 `task_ctl wait`）时按
+  `Ctrl+B` 把它转后台，不看输入框有没有字：工具行变成 `⎿ 已转后台 · 12s` 加跟随行，主回合接着走、可以继续对话，任务结束后以
+  `<task-notification>` 回合报告。没有可转的任务时 `Ctrl+B` 仍是光标左移。运行提示行带 `Ctrl+B 转后台`；tmux 里按 `C-b C-b`。
+  Agent 栏内 `b` 转后台选中的任务、`x` 连按两次停止；命令 `/tasks bg [id]` 同样可用（line 模式也认）。Esc 只中断前台，提示
+  里写明哪些后台任务仍在运行。后台任务的审批在主会话忙或输入框有草稿时不再弹框，停靠在 Agent 栏（「等待审批」，运行提示行
+  `↓ 处理审批`），主会话空闲且输入为空时自动弹出，打开该任务的视图时立即弹出；主会话与前台任务的审批不变。文档：docs/tui.md。
+- **后台子 Agent 的配置、`-p` 与 RPC**：新增 `subagents.background: "auto" | "always" | "never"`（缺省 auto：交互界面 / RPC / ACP
+  下 task 缺省后台，`-p` 下前台；调用参数与类型定义的 `background:` 优先）与 `subagents.autoBackgroundAfterMs`（前台任务运行超过
+  该毫秒数自动转后台，缺省 0 关闭），两键项目级也认、`/config` 面板可改。`-p` 主回合结束后若还有后台任务在跑，stderr 一行提示并
+  等它们结束、跑完通知回合再输出（受 `--max-turns` / `--max-cost` 约束，到限退出 8；Ctrl+C 照常中止），json 结果带 `tasks`。
+  RPC 新增 `background_task { taskId? }` → `{ backgrounded }` 与事件 `subagent_background`（共 44 条命令），SDK 为
+  `session.backgroundTask(taskId?)`。文档：docs/agents.md「前台与后台」、docs/rpc.md。
+- **Agent 栏重新可达**：空输入时的 `↓` 成为唯一缺省进栏键，本会话有任务即可进栏，栏收起后也行（以前要求栏可见）。`Ctrl+B`
+  不再进栏（tmux 缺省前缀会吃掉它），留给「前台任务转后台」，目前仍是光标左移（想要原来的键位写
+  `"app.agents.focus": ["down", "ctrl+b"]`）。输入框有字、`ui.agentBar: "off"` 或没有任务时按 `↓` 给一行提示，不再无声落空；
+  浏览输入历史时 `↓` 照旧翻历史。Agent 栏有任务时运行提示行末尾带 `↓ Agent 栏`（窄屏整项丢掉）。嵌入宿主（有 profile）
+  不再缺省关闭 Agent 栏，不要栏的宿主在 profile 的配置文件里写 `ui.agentBar: "off"`。
+- **子 Agent 缺省后台、前台任务可转后台**：TUI、RPC 与 ACP 下不写 `background` 的 `task` 立即返回 taskId，结果随后以
+  `<task-notification>` 到达；`-p` 仍缺省前台等待（配置 `subagents.background`：`auto`（缺省）/ `always` / `never`；类型
+  定义的 `background:` 与调用参数仍优先，内置类型不再固定 `background: false`）。阻塞中的前台 `task` 或 `task_ctl wait`
+  可以转后台（`session.backgroundTask(taskId?)`，事件 `subagent_background`）：工具立即返回固定文案「Moved to the
+  background …; it was not interrupted」，任务与父回合解绑（Esc 不再连带停止），完成后照常通知；
+  `subagents.autoBackgroundAfterMs`（缺省 0 关闭）到时自动转后台。`task` 描述与规则句按缺省后台改写（会话内不变；TUI 与
+  `-p` 的工具表因此不同）。
+
+- **ChatGPT 订阅模型的上下文窗口取后端值**：ChatGPT 后端模型列表给的上下文窗口（codex 的 `context_window`，siwc 条目带了也取）
+  现在优先于 models.dev——后者记的是 API 版窗口（部分模型 1.1M），订阅后端实际只收 272k，自动压缩按大窗口规划，长会话超过
+  272k 后请求被拒。models.dev 仍补后端没给的字段（输出上限等），但不再覆盖后端给的输入模态与推理强度；两边都没有上下文窗口时，
+  `chatgpt` 模型按保守缺省 128k，不再关闭自动压缩。`ama models discover chatgpt` 显示后端窗口并标「（后端）」，列出后端没给窗口
+  的模型。旧版本写的缓存不含窗口时照旧用 models.dev，重新 `ama models discover chatgpt` 即刷新。
+
+- **状态栏订阅配额行与配色**：当前模型走 ChatGPT 订阅时，`full` 布局在状态栏下方多一行
+  `5 小时：10.0% | 重置：2h 18m | 本周：31.0% | 本周重置：6d 5h`（来自 `quota_update`，每分钟刷新；窄于 80 列压缩为
+  `5h 10% ↻2h18m · 周 31% ↻6d5h`；codex 方式首次请求前显示占位，siwc 无数据与非订阅模型不显示）。`compact` 只在行尾追加短项
+  `5h 10% 周 31%`，既有顺序不变。`full` 三行按参考配色（标签暗灰；速率、时长与重置时间紫；模型、思考级别与输出量蓝；目录与分支绿；
+  费用黄；百分比按阈值），分支后显示领先 / 落后上游 `↑N` / `↓N`。文档：docs/tui.md「布局」。
+- **启动头换成 AMA 字符画与简短的点亮动画**：原来带框的信息块改为 5 行「AMA」字符画（块字符，按字母取主题的 accent → user → tool
+  三色；ASCII 模式用 `_ / \ |` 拼的字形），版本、模型、目录、模式与按键提示放在右侧（≥ 72 列）或下方（48–71 列）；窄于 48 列
+  退回两行简洁头。启动时播放一次约 1 秒的扫描点亮，原地定格、不在回滚里留帧；按任意键立即定格，按键照常进入输入框。
+  `ui.animation: false`、无色、非 TTY、嵌入宿主、`CI`、命令行带提示、终端过矮时不播放。新增 `ui.logo: "auto" | "off"`（off 只显示
+  信息行）。文档：docs/tui.md「启动画面」。
+
 ## 0.6.2（2026-10-03）
 
 - **ChatGPT codex 方式能列出模型，渠道跟随登录方式**：codex 模型列表（`GET /models?client_version=…`）原来发 ama 自己的版本号，