multiarena 0.1.0 → 0.1.3

package/CHANGELOG.md

@@ -0,0 +1,131 @@
+# Changelog
+
+## v0.1.3
+
+### 关键升级
+
+- **模式导航重构** — 广播/团队两种顶层模式，Tab 在模式内循环（概览 ↔ 模型），Esc 返回概览，Shift+Tab 切换模式
+- **团队私聊** — 审议完成后可 Tab 切换到任一模型继续对话，模型自动获得审议结果上下文
+- **镜像轮次审议** — 多模型从正向到反向接力（ABCBA），最终轮自动清理过程标注产出干净文档
+- **审议流程摘要** — 每轮显示修改处数和代表性修改内容，类似 git 提交记录
+- **审议继续修改** — 审议完成后在团队总览输入新要求即可启动新一轮修改
+- **对比模式退出修复** — 按 `d` 不会错误对比相同模型，支持 wrap-around 选择下一个不同模型
+
+### 关键 Bug 修复
+
+- **Esc 键在 Windows Terminal 不生效** — 绕过 Ink 的 `useInput`，使用原始 `process.stdin` 监听 `\x1b` 字节，35ms 超时区分独立 Esc 和转义序列
+- **Shift+Tab 只从概览生效** — 从定向模式按 Shift+Tab 不再意外切换，必须先 Esc 回概览
+- Tab 循环跳过静音模型，不会"卡"在不可见模型上
+- 审议完成后 Tab 发送消息不再错误启动新一轮审议
+- 广播模式 divider 渲染残留修复 — 移除冗余分隔线
+- 审议视图文字过暗修复 — 去除双重灰色叠加，添加滚动支持
+- 审议视图内容无法滚动 — 新增 `deliberationScrollOffset`，滚轮浏览审议历史
+- npm pack 缺少 `dist/` — 创建 `.npmignore` 覆盖 `.gitignore` 的 `dist/` 排除
+- 删除残留的 `StatusBar.js` / `.d.ts` 编译产物，新增 `prebuild` 清理步骤
+- 最终文档不再包含 `[修订:]` / `[补充:]` 过程标注
+- DeepSeek 不再将创意写作误判为编程任务（优化系统提示词）
+- Think-tag 过滤逻辑提取为可测试纯函数
+
+### 测试
+
+- 模式转换测试：48 个用例（含 `buildModeState`、error 状态、用户旅程）
+- Session 测试：28 个用例（含静音模型跳过、全静音边界）
+- 新增 CLI 参数解析测试：11 个用例
+- 新增 Provider 工厂测试：12 个用例
+- 新增 DeliberationView 组件测试：13 个用例
+- 新增 Think-tag 过滤器测试：17 个用例
+- 新增跨模块集成测试：19 个用例
+- Ollama adapter 测试从 4 个扩展到 15 个
+- Permission 测试新增 `deny_always`、`.git-credentials`、`grep .env` 覆盖
+- Registry 测试新增 `execute()` 成功路径和异常处理
+- 全部 30 个测试文件、311 个测试用例通过
+
+---
+
+## v0.1.2
+
+### 关键升级
+
+- **团队模式** — 多模型接力协作（起草 → 修订 → 润色 → 审查），产出一份经过多重打磨的文档
+- **/merge 合并命令** — 将各模型已有的回答合并为一份综合文档，标注共识和分歧
+- **Shift+Tab 模式切换** — 广播模式与团队模式一键切换，输入 `/team` 也可切换
+- **项目重新定位** — 从 AI 编程助手转向通用内容生成平台
+- **CHANGELOG.md** — 按版本记录关键升级、Bug 修复和测试覆盖
+
+### 关键 Bug 修复
+
+- Shift+Tab 在部分 Windows 终端上不生效，增加原始序列监听作为兜底
+- 删除死代码 `StatusBar.tsx`，提取 `formatTokens` 到独立文件
+- 移除 `cycleTargetReverse` 无用方法
+- 移除 `Ctrl+O` / `Ctrl+S` 多余快捷键，保持交互简洁
+
+### 测试
+
+- 新增 11 个 deliberation 测试用例（`autoAssignRounds`、`runDeliberation`、事件序列、约束注入、错误处理）
+- 全部 24 个测试文件、164 个测试用例通过
+
+---
+
+## v0.1.1
+
+### 关键升级
+
+- **MiniMax、DeepSeek Provider** — 6 家厂商全部接入
+- **Token 用量实时显示** — 广播和定向视图均显示每模型的 token 消耗
+- **上下文水位可配置** — `context_limit` 支持自定义，超出阈值有颜色预警
+- **Provider 超时与重试** — 请求超时自动中断，支持重试策略
+- **输入历史导航** — `↑↓` 键浏览历史输入
+- **滚动偏移** — 定向模式下 `↑↓` 可滚动查看长输出
+- **快捷键提示** — InputBar 底部常驻快捷键说明
+- **会话持久化** — `q` 退出自动保存，`--resume` 恢复历史会话
+- **孤儿 worktree 清理** — 启动时自动扫除上次崩溃遗留的 worktree
+- **CLI 参数** — `--help` / `--version` 支持
+- **配置校验** — 启动时警告缺失的模型或 API key
+
+### 关键 Bug 修复
+
+- bash 工具空命令导致 hang，改为优雅拒绝
+- 推理模型（DeepSeek-R1 等）的 `think` 标签被误当作正文输出，增加过滤
+- 工具调用参数为空时导致异常，增加兜底处理
+- MiniMax 中国区端点错误，改为 `minimax.chat`
+- Google Gemini 工具结果角色应为 `function` 而非 `tool`
+- Google Gemini 缺少工具调用循环处理
+- npm bin 路径多余 `./` 前缀导致安装警告
+
+### 测试
+
+- 新增 session 持久化测试（保存/加载/列表，5 个用例）
+- 新增 `runTurn` 工具调用循环测试（6 个用例）
+- 新增 UI 组件测试（`InputBar`、`formatTokens`）
+- 新增工具测试（`readFile`、`grep`、`bash`、`writeFile`、`editFile`）
+- 新增 `worktree` 隔离测试（5 个用例）
+- 新增 `permission` 权限测试（5 个用例）
+- 全部 24 个测试文件、164 个测试用例通过
+
+---
+
+## v0.1.0
+
+### 关键升级
+
+- **首个可用版本** — 终端原生多模型 AI 助手正式发布
+- **广播模式** — 消息同时发给所有模型，分栏并排查看回答
+- **定向模式** — Tab 切换选择单一模型对话，全宽详情视图
+- **6 家 Provider** — Anthropic、OpenAI、Google、DeepSeek、MiniMax、Ollama
+- **Provider 统一接口** — AsyncGenerator + Adapter 模式，新增厂商只需实现 `chat()` 方法
+- **git worktree 隔离** — 每个模型运行在独立的 worktree 中，文件系统无冲突
+- **6 个内置工具** — bash、read、write、edit、glob、grep
+- **权限管理** — 会话内记忆已授权操作，跨模型共享
+- **TOML 配置** — `.multiarenarc` 文件，支持 `${ENV}` 环境变量和全局/项目级覆盖
+- **对话历史** — 每个模型独立维护完整上下文
+
+### 关键 Bug 修复
+
+- Anthropic adapter 的 `AbortController` 在连续调用时会复用已中止的实例，改为每次调用新建
+- TOML 配置合并逻辑不完整，改用 `DEFAULT_CONFIG` 兜底
+- 修复 ESM 模块格式和 TypeScript 类型导入
+
+### 测试
+
+- Anthropic Provider 适配器测试（含 abort 场景）
+- TOML 配置加载与默认值合并测试

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tim Gunnar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,282 @@
+# multiarena
+
+终端原生多模型 AI 协作工具。一键提问，多个大模型同时回答；多模型接力审议，产出经过多重打磨的文档。
+
+## 模式系统
+
+multiarena 有两个顶层模式，各自包含总览和模型私聊两种视图：
+
+```
+广播模式 (Broadcast)               团队模式 (Team)
+  ├── 总览：多模型并排面板             ├── 总览：审议入口 / 审议结果
+  └── 定向：单个模型全宽详情           └── 定向：与单个模型私聊
+```
+
+### 输入栏前缀
+
+前缀告诉你当前处于哪个模式和视图：
+
+| 前缀 | 所处位置 |
+|------|---------|
+| `[all]` | 广播总览 — 消息发给所有模型 |
+| `[模型名]` | 广播定向 — 只跟该模型对话 |
+| `[team]` | 团队总览 — 输入任务启动审议 |
+| `[team:模型名]` | 团队定向 — 审议后与该模型私聊 |
+
+### 模式切换规则
+
+```
+          Shift+Tab (仅在总览时)          Shift+Tab (仅在总览时)
+广播总览 ←────────────────────→ 团队总览
+   ↑  ↓ Tab                        ↑  ↓ Tab
+广播定向                         团队定向
+   ↑                              ↑
+   └── Esc ───────────────────────┘── Esc
+```
+
+**Tab** — 在当前模式内循环切换目标。从总览进入第一个模型，再按切到下一个，循环回总览。Tab **永远不会**切换模式（不会在广播 ↔ 团队之间跳）。
+
+**Shift+Tab** — 在广播和团队之间切换。**只在总览时生效**，且切换后总是落在目标模式的总览。如果你在私聊中，需要先按 Esc 回总览，再按 Shift+Tab。
+
+**Esc** — 返回当前模式的总览。无论你在私聊、对比视图、还是审议进行中，Esc 都会带你回到当前模式的总览。Esc **永远不会**切换模式。
+
+**d** — 对比模式。输入栏为空时，按 `d` 将当前模型与另一个模型的回答并排展示，再按 `d` 退出。在总览中按 `d` 会将第一个模型作为主视图、第二个作为对比。
+
+---
+
+## 广播模式（启动默认）
+
+消息同时发给所有非静音模型，分栏并排查看回答。
+
+### 广播总览
+
+```
+┌─ claude ──────────────────────┐ ┌─ gpt ─────────────────────────┐
+│                               │ │                               │
+│  可以使用 ls 列出当前目录文件： │ │  你可以用 ls 或 dir 命令查看目 │
+│  $ ls -la                     │ │  录内容：                      │
+│  total 48                     │ │  $ ls                          │
+│  drwxr-xr-x  12 user  staff   │ │  src/  test/  package.json     │
+│                               │ │                               │
+│  3 lines · 1K/200K · done     │ │  3 lines · 1K/128K · done     │
+└───────────────────────────────┘ └───────────────────────────────┘
+────────────────────────────────────────────────────────────────────
+ claude ●  gpt ●   — Tab:model d:compare m:mute r:reset q:quit ↑↓:scroll
+[all] > ▊
+```
+
+提交消息后，所有非静音模型同时接收并回答。每个面板底部显示行数、token 用量和状态。
+
+### 广播定向（Tab 进入）
+
+按 `Tab` 进入某个模型的私聊视图。消息只发给该模型，输出区变为全宽详情。
+
+```
+┌─ claude ──────────────────────────────────────────────────────────┐
+│                                                                    │
+│  我来详细分析这个方案的优缺点：                                       │
+│                                                                    │
+│  **优点：**                                                         │
+│  1. 四层架构清晰，每层职责单一，易于测试和维护                          │
+│  2. Provider 接口设计简洁，新增模型只需实现 chat() 方法                │
+│                                                                    │
+│  2K/200K · 15 lines · done                                         │
+└────────────────────────────────────────────────────────────────────┘
+────────────────────────────────────────────────────────────────────
+ claude ●  gpt    — Tab:model d:compare m:mute r:reset q:quit ↑↓:scroll
+[claude] > ▊
+```
+
+再按 `Tab` 切换到下一个模型（跳过静音模型），循环回到总览。按 `Esc` 返回总览。
+
+### 对比模式（按 `d`）
+
+输入栏为空时按 `d`，将当前模型与下一个模型的回答并排对比。
+
+```
+┌─ claude ──────────────────────┐ ┌─ gpt ─────────────────────────┐
+│                               │ │                               │
+│  推荐使用策略模式，将每种算法封 │ │  建议用工厂模式配合依赖注入来解 │
+│  装为独立的策略类。            │ │  耦。                          │
+│                               │ │                               │
+│  2K/200K · 12 lines · done    │ │  1K/128K · 14 lines · done   │
+└───────────────────────────────┘ └───────────────────────────────┘
+────────────────────────────────────────────────────────────────────
+ claude ●  gpt ●   — Tab:model d:exit-compare m:mute r:reset q:quit
+[claude] > ▊
+```
+
+再按 `d` 退出对比，按 `Esc` 也能退出并回到总览。
+
+---
+
+## 团队模式（Shift+Tab 进入）
+
+多个模型接力协作，起草 → 修订 → 终审，产出一份经过多视角打磨的文档。
+
+### 启动审议
+
+在广播总览按 `Shift+Tab` 进入团队总览，输入任务描述后回车：
+
+```
+────────────────────────────────────────────────────────────────────
+团队模式
+
+输入任务描述即可启动多模型接力审议。
+Tab 可切换到特定模型私聊。Shift+Tab 返回广播模式。
+────────────────────────────────────────────────────────────────────
+ minimax  deepseek ●  — Tab:model d:compare m:mute r:reset q:quit
+[team] > 写一篇关于兰州拉面的美食日记▊
+```
+
+### 审议进行中
+
+模型按顺序接力：起草（模型 A）→ 修订（模型 B）→ 终审（模型 C）。每轮在上一轮的基础上改进。
+
+```
+┌─ 团队审议 ─────────────────────────────────────────────────────────┐
+│                                                                    │
+│ 第 2/3 轮：deepseek (修订)                                          │
+│                                                                    │
+│ ✓ 起草     ● 修订     ○ 终审                                        │
+│ minimax    deepseek  minimax                                       │
+│                                                                    │
+│ 修订中 — deepseek — 正在生成…                                       │
+│                                                                    │
+│ ## 今天吃了兰州拉面，我很开心                                        │
+│                                                                    │
+│ 今天中午去楼下那家兰州拉面馆…                                        │
+│                                                                    │
+└────────────────────────────────────────────────────────────────────┘
+────────────────────────────────────────────────────────────────────
+ minimax  deepseek ●  — Tab:model d:compare m:mute r:reset q:quit Esc:cancel
+[team] > ▊
+```
+
+审议进行中按 `Esc` 中止。
+
+### 审议完成
+
+审议结束后，显示审议过程和最终文档。每轮显示模型名称、角色、修改处数，以及代表性修改内容：
+
+```
+┌─ 团队审议 ─────────────────────────────────────────────────────────┐
+│                                                                    │
+│ 审议完成 · 3 轮 · 4 处修改                                          │
+│                                                                    │
+│ ✓ 起草    ✓ 修订     ✓ 终审                                         │
+│ minimax  deepseek  minimax                                         │
+│                                                                    │
+│ ── 审议过程 ──                                                      │
+│                                                                    │
+│ 1. minimax（起草）                                                   │
+│ 2. deepseek（修订） — 4 处修改                                       │
+│      明天还想去！ → 我决定下次再来。                                   │
+│      這個味道吧。 → 这个味道吧。                                      │
+│      明天还想再来一碗。 → 计划下次再品尝一次。                          │
+│ 3. minimax（终审） — 无修改                                          │
+│                                                                    │
+│ ── 最终文档 ──                                                      │
+│                                                                    │
+│ # 今天吃了兰州拉面，我很开心                                          │
+│ 今天中午去楼下那家兰州拉面馆…                                         │
+│                                                                    │
+└────────────────────────────────────────────────────────────────────┘
+────────────────────────────────────────────────────────────────────
+ minimax ●  deepseek ●  — Tab:model d:compare m:mute r:reset q:quit
+[team] > ▊
+```
+
+### 审议后与模型私聊
+
+审议完成后，按 `Tab` 切换到任一模型，可以就该模型在审议中的表现、最终文档的内容进行讨论。每个模型的对话历史中已自动注入审议结果上下文，模型知道自己参与了审议并了解最终成果。
+
+```
+按 Tab → [team:minimax] > 你觉得终审时deepseek的修改是否合理？
+```
+
+### 合并已有回答（`/merge`）
+
+先在广播模式下让各模型各自回答一个问题，然后在团队模式下输入 `/merge`，选一个模型把所有回答合并为综合文档，标注共识和分歧。
+
+---
+
+## 安装
+
+```bash
+npm install -g multiarena
+```
+
+## 快速开始
+
+```bash
+# 创建配置文件
+cat > .multiarenarc << 'EOF'
+[models.claude]
+provider = "anthropic"
+model = "claude-sonnet-4-6"
+api_key = "${ANTHROPIC_API_KEY}"
+
+[models.gpt]
+provider = "openai"
+model = "gpt-4o"
+api_key = "${OPENAI_API_KEY}"
+
+[defaults]
+active = ["claude", "gpt"]
+EOF
+
+# 启动
+multiarena
+```
+
+## 配置
+
+配置文件 `.multiarenarc`（TOML 格式），放在当前目录或 `~/.multiarenarc`。
+
+```toml
+[models.<名称>]
+provider = "anthropic"       # anthropic | openai | google | deepseek | minimax | ollama
+model = "claude-sonnet-4-6"  # API 模型名
+api_key = "${ENV_VAR}"       # API key，支持环境变量
+endpoint = "..."             # 自定义端点（可选）
+context_limit = 200000       # 上下文窗口大小（可选）
+
+[defaults]
+active = ["claude", "gpt"]   # 启动时加载的模型
+
+[deliberation]
+constraint_file = "rules.md" # 审议约束文件（可选）
+```
+
+会话保存至 `~/.multiarena/sessions/`。使用 `multiarena --resume <id>` 恢复历史会话。
+
+## 支持的模型
+
+| 厂商 | 模型 |
+|------|------|
+| Anthropic | Claude Sonnet 4.6、Opus 4.7、Haiku 4.5 |
+| OpenAI | GPT-4o、GPT-4.1 |
+| Google | Gemini 2.5 Flash、Gemini 2.5 Pro |
+| DeepSeek | DeepSeek-V4、DeepSeek-R1 |
+| MiniMax | MiniMax-M2.1 |
+| Ollama | 任意本地模型 |
+
+## 快捷键速查
+
+| 按键 | 功能 | 约束 |
+|------|------|------|
+| `Tab` | 当前模式内循环切换目标（总览 → 模型1 → 模型2 → 总览） | 不切换模式，跳过静音模型 |
+| `Shift+Tab` | 广播 ↔ 团队模式切换 | **仅在总览时生效**，切换后落在目标模式总览 |
+| `Esc` | 返回当前模式总览 / 退出对比 / 中止审议 | 不切换模式 |
+| `d` | 对比两个模型的回答（输入栏为空时） | 需要至少 2 个非静音模型 |
+| `m` | 静音/取消静音当前模型 | 定向模式下生效 |
+| `r` | 重置当前模型对话历史 | 定向模式下生效 |
+| `↑ ↓` | 输入为空：浏览历史输入；输入非空：滚动输出 | 团队总览下审议内容也可滚动 |
+| `/team` | 等同于 Shift+Tab | |
+| `/merge` | 合并各模型最近的回答 | 需要至少 2 个模型有回复 |
+| `q` | 退出（自动保存会话） | |
+
+## License
+
+MIT

package/dist/cli/args.d.ts

@@ -0,0 +1,11 @@
+export declare function getPkgVersion(): string;
+/** Override for tests. */
+export declare function setPkgVersion(v: string): void;
+export declare const HELP = "multiarena \u2014 Multi-Model AI Coding Assistant\n\nUsage:\n  multiarena [options]\n\nOptions:\n  --new              Start a new session (default)\n  --resume <id>      Resume a saved session\n  --list             List saved sessions\n  --help             Show this help\n  --version          Show version";
+export interface ParsedArgs {
+    sessionId?: string;
+    listOnly: boolean;
+    showHelp: boolean;
+    showVersion: boolean;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;

package/dist/cli/args.js

@@ -0,0 +1,56 @@
+import { fileURLToPath } from "node:url";
+import * as fs from "node:fs";
+import * as path from "node:path";
+// __dirname won't be available in this module; use a static path for PKG_VERSION.
+// We store the pkg version lazy-loaded so tests don't need a real package.json.
+let _pkgVersion = null;
+export function getPkgVersion() {
+    if (_pkgVersion !== null)
+        return _pkgVersion;
+    try {
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        const pkgPath = path.join(__dirname, "..", "..", "package.json");
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        _pkgVersion = pkg.version ?? "0.1.0";
+    }
+    catch {
+        _pkgVersion = "0.1.0";
+    }
+    return _pkgVersion;
+}
+/** Override for tests. */
+export function setPkgVersion(v) {
+    _pkgVersion = v;
+}
+export const HELP = `multiarena — Multi-Model AI Coding Assistant
+
+Usage:
+  multiarena [options]
+
+Options:
+  --new              Start a new session (default)
+  --resume <id>      Resume a saved session
+  --list             List saved sessions
+  --help             Show this help
+  --version          Show version`;
+export function parseArgs(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        return { listOnly: false, showHelp: true, showVersion: false };
+    }
+    if (argv.includes("--version") || argv.includes("-v")) {
+        return { listOnly: false, showHelp: false, showVersion: true };
+    }
+    const resumeIdx = argv.indexOf("--resume");
+    if (resumeIdx >= 0 && argv[resumeIdx + 1]) {
+        return {
+            sessionId: argv[resumeIdx + 1],
+            listOnly: false,
+            showHelp: false,
+            showVersion: false,
+        };
+    }
+    if (argv.includes("--list") || argv.includes("--list-sessions")) {
+        return { listOnly: true, showHelp: false, showVersion: false };
+    }
+    return { listOnly: false, showHelp: false, showVersion: false };
+}

package/dist/config/loader.js

@@ -48,8 +48,8 @@ export function validateConfig(config) {
 }
 export function loadConfig() {
     const candidates = [
-        path.join(process.cwd(), ".arenarc"),
-        path.join(os.homedir(), ".arenarc"),
+        path.join(process.cwd(), ".multiarenarc"),
+        path.join(os.homedir(), ".multiarenarc"),
     ];
     let resolved = {};
     for (const p of candidates) {

package/dist/config/types.d.ts

@@ -1,15 +1,25 @@
 export interface ModelConfig {
-    provider: "anthropic" | "openai" | "google" | "ollama";
+    provider: "anthropic" | "openai" | "google" | "ollama" | "deepseek" | "minimax";
     model: string;
     api_key?: string;
     endpoint?: string;
     context_limit?: number;
 }
+export interface DeliberationConfig {
+    /** Models and their round roles in order. E.g. [{ model: "claude", role: "draft" }, ...] */
+    rounds: Array<{
+        model: string;
+        role: "draft" | "revise" | "polish" | "review";
+    }>;
+    /** Path to a constraint document (markdown), relative to project root. */
+    constraint_file?: string;
+}
 export interface ArenaConfig {
     models: Record<string, ModelConfig>;
     defaults: {
         active: string[];
         broadcast: boolean;
     };
+    deliberation?: DeliberationConfig;
 }
 export declare const DEFAULT_CONFIG: Partial<ArenaConfig>;

package/dist/core/deliberation.d.ts

@@ -0,0 +1,53 @@
+import type { ModelConfig } from "../config/types.js";
+export type RoundRole = "draft" | "revise" | "polish" | "review";
+export interface DeliberationRoundConfig {
+    modelName: string;
+    role: RoundRole;
+    config: ModelConfig;
+}
+export interface DeliberationProgress {
+    type: "round_start" | "text" | "round_end" | "done" | "error";
+    round: number;
+    totalRounds: number;
+    modelName?: string;
+    role?: RoundRole;
+    content?: string;
+    document?: string;
+    error?: string;
+    /** Number of revision annotations found in this round's output. */
+    changeCount?: number;
+    /** A few representative revision snippets from this round. */
+    changeSamples?: string[];
+}
+export interface DeliberationResult {
+    finalDocument: string;
+    rounds: Array<{
+        modelName: string;
+        role: RoundRole;
+        document: string;
+    }>;
+}
+/**
+ * Run the R2D2 (Round-Robin Deliberative Drafting) pipeline.
+ *
+ * Models take turns in sequence: the first drafts, the second revises,
+ * the third polishes, and optionally a fourth reviews. Each round's
+ * system prompt injects the task, constraint document, and previous
+ * round output for context. No central synthesizer — the document
+ * emerges through sequential refinement.
+ */
+export declare function runDeliberation(task: string, roundConfigs: DeliberationRoundConfig[], constraint?: string, worktreePath?: string): AsyncGenerator<DeliberationProgress>;
+/** Build round configs with mirror pattern: A→B→C→B→A. */
+export declare function autoAssignRounds(modelNames: string[], models: Record<string, ModelConfig>): DeliberationRoundConfig[];
+/** Human-readable label for a round role. */
+export declare function roundLabel(role: RoundRole): string;
+export interface MergeInput {
+    modelName: string;
+    content: string;
+}
+/**
+ * Synthesize existing model outputs into one final document.
+ * Single-turn: one model acts as the merger, combining all outputs
+ * into a coherent document with source annotations and conflict notes.
+ */
+export declare function runMerge(task: string, outputs: MergeInput[], mergerConfig: ModelConfig, mergerName: string): AsyncGenerator<DeliberationProgress>;