@aragon-agent/cli 0.6.11 → 0.6.13

package/CHANGELOG.md

@@ -5,7 +5,16 @@ All notable changes to `@aragon-agent/cli` are documented here. Entries at
 — those releases really were published under that name, so they are left as they
 were written.
 
-## Unreleased
+## Unreleased
+
+### TUI 输入与排队可靠性
+
+- Shift+Enter 与粘贴按输入顺序处理；普通 Enter 保持弹层兼容，混合输入最多提交一次，
+  余稿及拒绝提交的正文保留。结束输入流时完整排空，不泄漏内部控制标记。
+- 超限粘贴拒绝同一外部输入块的正文和 Enter，避免误提交旧稿；未闭合粘贴继续按正文消费。
+- 拖选后仅 Ctrl+C 复制；文字变化与丢失鼠标释放时取消无效高亮，避免卡住视口。
+- 固定 Queue 状态行按消息 ID 回执更新，支持窄屏、暂停与多条消息计数。
+- 保存和退出保留所有未发送全文；恢复先验证存档，旧 queued 作为警告展示且不自动重放。
 
 ### Removed
 

package/README.md

@@ -432,8 +432,8 @@ completes, `Up` / `Down` moves the selection, `Esc` closes it.
 
 | Key | Action |
 | --- | --- |
-| `Enter` | Submit (idle) / queue a steering message (running) — shown as `Queue: …` until the agent picks it up |
-| `Ctrl+J` / `Alt+Enter` / `Shift+Enter` | Insert a newline. `Ctrl+J` and `Alt+Enter` work everywhere; a distinct `Shift+Enter` needs a one-line terminal binding — see [`/terminal-setup`](#terminal-setup) |
+| `Enter` | 空闲时发送，运行时加入队列；收到 Core 已纳入会话的接收凭据后才移除 Queue 提示 |
+| `Ctrl+J` / `Alt+Enter` / `Shift+Enter` | 插入换行。Ctrl+J 已通过输入链路测试；另外两种组合键需要宿主发送独立序列，Alt+Enter 可能被宿主拦截。参见 [终端设置](#terminal-setup-for-shiftenter) |
 | `Shift+Tab` | Toggle **plan mode** (`BUILD` <-> `PLAN`). Equivalent: `/plan`. On Windows this needs a console flag Node < 22.17 does not set; aragon sets it at startup — see [Requirements](#requirements) |
 | `Ctrl+P` | The same toggle, over a channel no Windows console can swallow. Use it if `Shift+Tab` does nothing |
 | `Esc` | Close an overlay or popup; otherwise ask for interruption confirmation. While idle, cancel pending auto-continuation |
@@ -452,7 +452,7 @@ completes, `Up` / `Down` moves the selection, `Esc` closes it.
 | `Alt/Ctrl+←` / `→` | Word-wise cursor jump |
 | `Ctrl+W`, `Alt+Backspace` | Delete the previous word |
 | `Ctrl+U` / `Ctrl+K` | Kill to line start / end |
-| `Up` / `Down` | Move between draft lines; recall prompt history at the edges |
+| `Up` / `Down` | 按视觉行移动；空草稿或正在浏览历史时，才在边界召回历史，避免覆盖新草稿 |
 | Paste | Inserted as-is up to 6 lines / 400 chars; larger collapses to `[Pasted text #1 +15 lines]`, which deletes as one unit and expands in full when you send. `--no-paste` restores the pre-0.6.3 behaviour |
 | `?` | Open help (empty input) |
 
@@ -462,7 +462,7 @@ new output automatically; once you scroll away the status bar shows `↑N`, a sl
 scrollbar occupies the terminal's last column (including 40-column windows). Drag its thumb
 to move through history, or click the track to move one page. Messages, the team panel
 and the input area scroll together; typing or editing returns to the input without
-losing the draft. The fixed status row shows `PgDn down` while reading history.
+losing the draft. The fixed status row reports the distance from the end while reading history.
 `PgDn` moves one page down; editing or submitting returns directly to the end.
 
 **The mouse wheel is a viewport gesture and nothing else.** Wherever the pointer
@@ -493,15 +493,14 @@ is what it used to do. Inline mode is unaffected either way.
 
 ## Terminal setup for Shift+Enter
 
-`Ctrl+J` and `Alt+Enter` insert a newline in every terminal with no setup. A
-dedicated `Shift+Enter` key needs the terminal to send the CSI-u sequence
-`\u001b[13;2u` instead of a plain `Enter` — run `/terminal-setup` inside aragon
-for copy-paste bindings per terminal:
+输入支持 `Ctrl+J`、`Alt+Enter` 和可独立编码的 `Shift+Enter` 换行。如果终端把
+Shift+Enter 与 Enter 都发送为 CR，应用无法区分；请用 `/terminal-setup` 查看绑定，
+让 Shift+Enter 发送 `\u001b[13;2u`。合并到已有终端配置，不要覆盖其他快捷键；
+终端拦截某个组合键时可使用另外两种方式。参考绑定如下：
 
-- **Windows Terminal** — `settings.json`, `actions`:
-  `{ "keys": "shift+enter", "command": { "action": "sendInput", "input": "\u001b[13;2u" } }`
+- **Windows Terminal** — `settings.json` 的 `actions` 与 `keybindings` 分别定义动作和按键；完整示例见下文“输入、待处理队列与底部状态区”。
 - **VS Code integrated terminal** — `keybindings.json`:
-  `{ "key": "shift+enter", "command": "workbench.action.terminal.sendSequence", "args": { "text": "\u001b[13;2u" } }`
+  `{ "key": "shift+enter", "command": "workbench.action.terminal.sendSequence", "when": "terminalFocus", "args": { "text": "\u001b[13;2u" } }`
 - **iTerm2** — Settings > Profiles > Keys > Key Mappings, `Shift+Enter` ->
   *Send Escape Sequence* `[13;2u`
 - **kitty / WezTerm / foot** — native once keyboard-enhancement mode is on
@@ -518,20 +517,29 @@ user-side binding reaches the same result for the one key that needs it.
 
 ## Queued messages while the agent runs
 
-Sending a message while a run is in flight **queues** it for the agent's next
-turn. The transcript shows the queue honestly:
+Agent 运行中发送的消息会进入队列。输入框附近的独立 Queue 面板按顺序显示摘要，
+限高后显示隐藏条数；固定状态栏始终显示真实待处理总数，没有自动消失的时间限制。
+使用 `/queue` 分页查看所有消息的完整原文，未接收消息不会在普通转录中重复显示：
 
 ```
 ◷ Queue: also check the tests
 ```
 
-The row stays until Core actually accepts the message into the conversation —
-the next `turn_start` — at which point it is rewritten **in place** into the
-user message it became, followed by the answer. Interrupting the run does not
-clear it: the message really is still queued, and it will be picked up when
-you continue the session. Messages still queued when the session is saved are
-restored as `Queued but never sent: …` warnings, because the in-memory queue
-does not survive a restart.
+仅当 Core 将消息写入对话历史并发出对应消息 ID 的接收回执，Queue 状态才移除。
+这表示引擎已接管后续处理，不表示回答完成；`turn_start`、动画和提示超时都不能代替回执。
+相同正文的两次发送仍是两条消息。中断或失败后尚未接收的消息保留并标记暂停。
+窄屏优先保留运行状态、待处理数量和上下文；其他字段整项隐藏，不截断关键数值。
+快捷键集中在操作提示行，并随覆盖层、补全、选区和中断确认状态变化。
+
+`/clear` 清转录和 TODO，但保留待接收队列。保存和退出会补回被清屏或保留环裁剪的
+未发送全文。恢复存档时，queued 一律成为 `Queued but never sent: ...` 警告，
+不会自动重发；需要发送时请复制正文重新提交。运行尚未退出时 `/reset`、`/resume`
+会拒绝切换，损坏存档在替换当前会话之前报错。
+
+应用捕获鼠标时，拖选只保留高亮，按 Ctrl+C 才复制；本次按键不会停止服务或退出。
+选中文字改变、滚轮、其他按键或关闭选区会取消高亮。`--no-mouse` 或宿主原生选择的
+选中即复制由终端设置控制。OSC 52 发送成功仅证明请求已发出，不保证远程终端剪贴板
+已写入；SSH/tmux 是否允许该请求需在实际环境中验证。
 
 ## Themes
 
@@ -2334,3 +2342,72 @@ UTF-16 编辑和 ZWJ/组合字形仍有既有限制，本次修复保证视觉
 检查流式输出不阻止闪烁；单 ESC 不停止任务，两击中断，卡住时第三击强停；菜单关闭不计入两击。
 任务结束后保留最终计划，下一条普通消息启动时旧计划消失，新有效计划出现才恢复；显式续跑保留计划。
 强停后立即提交，在等待中双 ESC 取消，旧引擎退出后不得自行执行已取消的消息。
+
+## 输入、待处理队列与底部状态区
+
+Enter 在空闲时发送，运行时加入队列；启动阶段拒绝重复提交并保留草稿。
+Ctrl+J 换行；终端能发送独立序列时，Shift+Enter 与 Alt+Enter 也可换行。
+光标按完整字素移动，支持中文、组合字符和 emoji；输入最多占终端高度四分之一且不超过六行。
+括号粘贴保留换行，不触发发送。过滤器或粘贴支持关闭时，不保证未标记多行粘贴安全。
+过滤器不可用时 Delete 保守按 Backspace 处理，避免退格误删后文。
+
+应用鼠标拖选只建立选区，Ctrl+C 才复制；复制中再次按 Ctrl+C 不会退出或停止服务。
+原生剪贴板工具完成后显示确认，OSC 52 只表示请求已发送，终端可能拒绝。
+Shift+拖动或 `/mouse off` 后的选区由宿主管理，应用无法关闭宿主的自动复制。
+
+Queue 面板逐条显示待处理消息，数量始终留在状态栏。只有 Core 已把消息纳入会话并发回接收凭据，
+该条提示才会消失。中断时未接收消息显示暂停；`/queue` 可分页查看全部原文，Esc 关闭。
+`/clear` 不丢待处理消息；`/reset`、切换会话会明确报告取消数量；恢复保存的未发送历史不会自动重发。
+
+底部依次为输入框、固定操作提示/短反馈行、全局状态栏。状态字段按显示宽度完整保留或整项隐藏。
+上下文表示当前主 Agent 的已用/上限 tokens；`~` 表示含估算，`?` 表示上限未知。
+费用是含子代理、快速模型及压缩的会话估算 USD，恢复会话沿用累计，缺价格按零计，零值不保证免费。
+本轮均速是本轮期间入账输出 token 增量除以耗时，可能包含上述辅助调用，并非瞬时生成速度。
+`/context` 提供统计范围和完整值。
+
+Windows Terminal：在设置 JSON **根级**添加 `"copyOnSelect": false`，把以下条目合并到已有数组：
+
+```json
+{
+  "actions": [{ "id": "User.AragonNewline", "command": {
+    "action": "sendInput", "input": "\u001b[13;2u"
+  } }],
+  "keybindings": [{ "keys": "shift+enter", "id": "User.AragonNewline" }]
+}
+```
+
+依据：[Windows Terminal 交互设置](https://learn.microsoft.com/en-us/windows/terminal/customize-settings/interaction)、
+[按键动作](https://learn.microsoft.com/en-us/windows/terminal/customize-settings/actions)。PowerShell 是 shell，不能在其 profile 中设置终端按键映射。
+
+VS Code 用户设置添加 `"terminal.integrated.copyOnSelection": false`，快捷键 JSON 添加：
+
+```json
+{
+  "key": "shift+enter", "command": "workbench.action.terminal.sendSequence",
+  "when": "terminalFocus", "args": { "text": "\u001b[13;2u" }
+}
+```
+
+依据：[终端基础](https://code.visualstudio.com/docs/terminal/basics)、
+[终端高级设置](https://code.visualstudio.com/docs/terminal/advanced)。应用的 `/terminal-setup` 只输出说明，不修改宿主配置。
+若宿主把 Shift+Enter 或 IME 候选确认同样编码为 CR，应用无法从相同字节推断用户意图。
+可使用经输入链路测试的 Ctrl+J、独立 CSI-u 绑定及外部编辑后括号粘贴；具体宿主组合仍需实测。
+双宿主、微软拼音及持续流式性能验收状态见 `docs/plans/tui-composer-queue-status/manual-test.md`。
+
+## 多套模型配置
+
+在 `/settings` 中使用 **Main profile** 和 **Fast profile**，可以分别为主任务与快速模型选择已保存的方案。两种角色共享配置库，但各自选择互不影响，也可以选择同一个方案。**Manage profiles** 提供新建、编辑、复制和删除；名称留空时采用模型名。同名方案通过地址主机和唯一 ID 区分。超过八条时按 `/` 搜索名称、模型或服务商。
+
+上下方向键或 Tab 移动，Enter 选择或编辑，根设置页 Ctrl+S 保存。普通文本字段的 Enter 仍保存设置。选择和子表单的修改先进入草稿；Esc 返回或确认丢弃。被主模型或快速模型引用的方案必须先解除绑定才能删除。复制包含本轮已经编辑的凭据，并产生新的 ID。
+
+方案保存服务商、模型、地址和凭据，不改变思考级别、token 上限、快速评审频率或预算。选择快速模型方案不会自动启用快速层。若本次启动时快速层未注册，首次启用会提示“已保存，待重启”；缺少模型或凭据时也需要先补齐。
+
+**Current custom** 保留旧式连接，可继续编辑原连接字段。创建方案时从磁盘上的旧式配置预填，不复制环境变量或 `--api-key` 的运行时密钥。专属密钥可保持、替换或切换为共享/环境凭据；修改服务商或地址后，必须明确选择保留原密钥，或重新输入。空地址在方案中表示服务商默认地址，快速方案不会继承主网关。
+
+启动优先级为 CLI 参数、环境变量、所选方案、旧式字段、默认值。界面显示启动覆盖；明确重新选择方案可对本次会话立即生效，重启仍遵循启动参数。专属密钥仅对对应角色和目标地址生效；主模型启动密钥不会跟随切换发往另一个网关。
+
+运行、团队任务、后台评审或压缩尚未结束时禁止保存。保存采用原子文件替换，同时检查磁盘与当前会话版本；失败保留草稿，发生冲突时选择 Reload settings。写入已成功但会话应用异常时会明确提示重启并禁用重复保存。跨进程版本检查属于乐观检查，不能消除同时写入的极小竞态。
+
+`/model`、`/fast model` 和 `config set` 修改连接会回到对应角色的自定义配置。若解除绑定会丢失专属账户或默认地址语义，命令会拒绝并引导到设置中编辑或复制。`/reload` 会一起刷新两个角色的连接和凭据，保留对话与用量。
+
+配置库仍位于 `ARAGON_HOME` 指向目录中的 `config.json`，不写入会话文件。密钥按现有机制明文保存：POSIX 创建权限为 0600，Windows 依赖用户目录 ACL，不提供加密。`config get/list` 对方案密钥使用固定掩码；损坏或未来版本的配置段整体隐藏。既有 `config edit` 备份也包含凭据。关闭通用日志脱敏、使用短密钥或分享第三方 SDK 错误日志时，仍需自行检查日志内容。

package/dist/agent/controller.d.ts

@@ -1,3 +1,5 @@
+import { type ModelSettingsSnapshot } from './model-profile-settings.js';
+import type { ModelSettingsDraft, ModelSettingsPatch, ModelSettingsSaveResult } from '../config/model-profile-store.js';
 /**
  * AgentController — builds the core `Agent`, wires the built-in toolset, and
  * exposes a small run/abort/steer surface plus the pre-flight validation that
@@ -11,6 +13,7 @@
 import type { PromptOptions, PromptOutcome } from './prompt-options.js';
 import { ModelRegistry, type AgentEvent, type AgentTool, type Message, type ModelInfo, type ModelRef, type ProviderRegistry, type ThinkingLevel } from '@aragon-agent/core';
 import type { CliConfig, CompactionConfig, FastConfig, RetryConfig, TeamConfig, ThemeName, TodoConfig } from '../config/schema.js';
+import type { ModelRole } from '../config/model-profiles.js';
 import { type ConfirmRequest } from '../tools/index.js';
 import type { ToolPermission } from '../exec/permission.js';
 import { type ToolOutputListener } from '../tools/tool-output-store.js';
@@ -180,6 +183,9 @@ export declare class AgentController {
     private readonly outputListeners;
     private readonly fast;
     private readonly compaction;
+    private settingsRevision;
+    private modelSettingsBlocked;
+    private preparedSystemPrompt;
     private readonly contextMeter;
     private readonly procs;
     /**
@@ -214,8 +220,11 @@ export declare class AgentController {
      * Cleared at the next `agent_start`.
      */
     private abortRequested;
-    /** User messages queued since the last `turn_start` (§3.5.4a guard 2). */
-    private userSteerCount;
+    /** Only exact acceptance receipts release user messages from reviewer protection. */
+    private readonly pendingUserSteering;
+    /** Session changes must not make a delayed receipt match a new message. */
+    private readonly steeringPrefix;
+    private steeringSequence;
     constructor(config: CliConfig, deps?: ControllerDeps);
     private resolveKey;
     /**
@@ -246,7 +255,7 @@ export declare class AgentController {
      * Read-only CLI-layer helper for the Header/Welcome key-status dot (P1-1);
      * does not touch `@aragon-agent/core`.
      */
-    hasApiKey(provider?: string): boolean;
+    hasApiKey(provider?: string, role?: ModelRole): boolean;
     /**
      * Set the color theme live. Mirrors the `setModel` / `setThinkingLevel`
      * mutator pattern — a subsequent re-render re-reads `getConfig().theme` and
@@ -360,7 +369,11 @@ export declare class AgentController {
      * which it has to be, since a normal quit reaches it twice.
      */
     reapServicesSync(): void;
+    /** Queue automation/user guidance with the same protection as visible input. */
     steer(text: string): void;
+    /** Return the opaque ID used by the view to match Core's acceptance receipt. */
+    queueUserMessage(text: string): string;
+    private enqueueSteering;
     followUp(text: string): void;
     isRunning(): boolean;
     getAgentMode(): AgentMode;
@@ -517,6 +530,28 @@ export declare class AgentController {
      * the runtime nor the file.
      */
     setRetryConfig(patch: Partial<RetryConfig>): RetryConfig;
+    /** True while any request can still use a model or credential snapshot. */
+    isModelSettingsBusy(): boolean;
+    /** Monotonic revision protects an editor from all intervening settings changes. */
+    getSettingsRevision(): number;
+    /** Read-only draft creation; no startup migration or credential copying. */
+    createModelSettingsDraft(): ModelSettingsDraft;
+    /** Save an explicit draft as a single disk/live transaction. */
+    saveModelSettings(draft: ModelSettingsDraft): ModelSettingsSaveResult;
+    /** Legacy commands share the same lossless conversion and atomic save path. */
+    saveModelSettingsPatch(patch: ModelSettingsPatch): ModelSettingsSaveResult;
+    /** Refresh both role connections and credentials while retaining conversation state. */
+    reloadModelSettings(): ModelSettingsSaveResult;
+    /** Prebuild all potentially failing model/prompt work before committing the file. */
+    prepareModelSettingsSnapshot(config: CliConfig): ModelSettingsSnapshot;
+    /** Apply prepared state synchronously, without rebuilding the controller or its history. */
+    applyModelSettingsSnapshot(snapshot: ModelSettingsSnapshot): void;
+    /** Potentially failing ordinary-setting side effects are isolated from model application. */
+    applyModelSettingsEffects(): void;
+    /** A partially applied model snapshot must never reach another provider request. */
+    blockModelSettingsRequests(): void;
+    /** The UI uses this before accepting or draining queued prompts. */
+    areModelSettingsBlocked(): boolean;
     setModel(provider: string, model: string, baseUrl?: string): void;
     setThinkingLevel(level: ThinkingLevel): void;
     setMaxTokens(value: number | undefined): void;