@harness-mix/cli 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.2.1 — 2026-09-18
+
+- Turn transcripts now match Codex's native three-stage experience: opening remarks and inter-tool commentary stream live as progress-phase agent messages alongside command rows while the turn runs, and on completion Codex Desktop folds every progress segment and tool item under the elapsed-time bar, leaving only the final-phase conclusion visible. The previous buffer-and-reclassify-as-reasoning approach (which hid narration while running) is removed.
+- Runtime hardening: cancelling while a send is still opening the session or assembling the prompt no longer strands an invisible zombie run — the cancel is recorded and settled before the prompt is delivered; a watchdog now settles running turns that produce no events for 15 minutes (approval waits excluded) so the UI stops spinning and review snapshots finalize instead of hanging forever.
+- Pi-family and Claude adapters: a Host-side projection exception can no longer kill the native event pump; Pi `message_end` failures wait for `agent_end`'s `willRetry` so automatic retries are no longer reported as final errors (mid-retry user messages are queued as native follow-ups instead of hitting "Agent is already processing"), and an abort issued during prompt preflight is re-issued after the ack so the just-started run is actually stopped.
+- Collaboration cards: the spawnAgent card settles as done as soon as the child session is ready and execution state moves to a separate sendInput card, so Desktop no longer shows "creating agents" for the whole run; team cards settle when the team completes.
+- Workspace reviews positively exclude edits whose paths were reported by other concurrent sessions' harnesses, keeping each turn's diff and undo list attributable to its own session.
+- Desktop pet switching in the Pets settings page: the **Use / 使用** button on an installed pet now switches **Codex Desktop's official pet** by driving the app's own UI (profile menu → Settings → official Pets settings → the pet's card, live-verified against Codex Desktop 26.908), so the native mascot (the profile-menu / Show-pet companion window) changes accordingly. A "Now showing / 当前桌宠" panel at the top of the page mirrors the pet Harness Mix last switched to (persisted as a small local record; clearing it never touches the official mascot — visibility stays with Codex's own Show pet toggle), and the active card gets an "Active / 使用中" badge. No account APIs are called and no credentials are touched: selection happens through genuine DOM clicks on Codex's own settings UI.
+- Settings → Collaboration is a new page with two independent switches (both on by default): **Multi-Agent collaboration** (the `#` mention menu, delegation tools and coordinator prompt are fully disabled when off) and **Agent Team** (`create_agent_team` and the other team tools are hidden from the injected MCP server and rejected Host-side when off, while one-shot delegation stays available). Preferences persist across Host restarts.
+- The skin marketplace grows from 17 to 30 built-ins: the **Gothic Void Crusade** background theme redistributed from Fei-Away/Codex-Dream-Skin (MIT, artwork by @seansong-ideogram), and twelve classic editor palette themes (Catppuccin Latte/Mocha, Claude Desktop dark/light, Gruvbox dark/light, Nord dark/light, One Dark/Light, Tokyo Night dark/light) derived from miniLV/Anthropic-codex-theme (MIT). License texts and provenance are recorded under licenses/ and src/assets/skins/dream-skin/.
+- Native protocol: collaboration child threads project as `subAgentThreadSpawn`, so Desktop's sub-agent cards open the child session on click instead of silently doing nothing.
+- Workspace reviews: concurrent same-directory sessions now show per-session diffs narrowed to the files their own tools touched (lead turns include collaboration children), line-diff ignores CR/LF-only changes (no more full-file phantom diffs), file edits refresh the review ~250ms after landing instead of on a 3s poll, and `turn/diff/updated` notifications are deduplicated per turn.
+
 ## 0.2.0 — 2026-09-17
 
 - **Agent Team**：新增持久的多 Harness 智能体团队 —— 一个 Lead 可组织最多六个并发的具名 Harness 成员，共享依赖感知的任务图、成员邮箱与直接会话投递，并配备会话内实时 Team Workbench（明确职责、按成员的任务泳道、Harness 图标、成员会话跳转与可回放的状态历史）。Added durable multi-Harness Agent Teams: one Lead orchestrates up to six concurrent named Harness members with a dependency-aware shared task graph, teammate mailboxes/direct session delivery, and a live in-conversation Team Workbench with explicit responsibilities, per-member task lanes, Harness icons, member-session navigation, and replayable state history.

package/NOTICE

@@ -25,6 +25,20 @@ The original artwork is licensed under Creative Commons Attribution 4.0.
 Upstream attribution and asset license records are preserved under
 src/assets/skins/codex-styler/. The upstream software is Apache-2.0 licensed.
 
+One bundled skin background (Gothic Void Crusade) is redistributed from
+Fei-Away/Codex-Dream-Skin under the MIT License, with original artwork
+contributed to the upstream project by @seansong-ideogram.
+Source: https://github.com/Fei-Away/Codex-Dream-Skin
+The upstream license text is preserved in licenses/codex-dream-skin-MIT.txt.
+Upstream attribution records are preserved under src/assets/skins/dream-skin/.
+
+Twelve bundled palette-only skins (Catppuccin, Claude Desktop, Gruvbox, Nord,
+One Dark/Light, Tokyo Night color schemes) are derived from
+miniLV/Anthropic-codex-theme under the MIT License.
+Source: https://github.com/miniLV/Anthropic-codex-theme
+The upstream license text is preserved in licenses/anthropic-codex-theme-MIT.txt.
+These skins carry color values only; no upstream artwork is redistributed.
+
 Twenty-four icons under src/assets/icons/ are redistributed from lobehub/lobe-icons
 under the MIT License. Copyright (c) 2023 LobeHub.
 Source: https://github.com/lobehub/lobe-icons

package/README.md

@@ -77,7 +77,7 @@ Harness Mix 是接入官方 Codex Desktop 原生界面的本地内核。它通
 | 功能模块 | 核心能力 | 交互入口与特点 |
 | :--- | :--- | :--- |
 | **🔄 跨 Harness 任务接力** | 4 种接力模式（继续执行 / 执行计划 / 独立审查 / 重新分析）平滑交接 | 输入框接力角标 / `/switch`；持久化脱敏检查点与证据追溯 |
-| **🎨 皮肤市场** | 内置 HeiGe 与 Codex Styler 主题，支持亮色 / 暗色、背景装饰和可读性保护 | 设置 → 皮肤；一键预览、应用和恢复原生外观 |
+| **🎨 皮肤市场** | 内置 HeiGe、Codex Styler、Dream Skin 与经典编辑器配色主题，支持亮色 / 暗色、背景装饰和可读性保护 | 设置 → 皮肤；一键预览、应用和恢复原生外观 |
 | **📚 历史会话导入与引用** | 一键导入 Pi / Claude / Codex / CodeBuddy 原生历史并可中断续跑；`#` 引用任意旧会话注入脱敏上下文 | 引用仅预取最近一页；MCP 只读工具 `get_session_info` / `list_session_messages` 供 Harness 按需翻页与读取分支 / 模型 / 用量元数据 |
 | **🤝 多 Agent 协同编排** | 输入 `#` 唤起目标 Harness，胶囊标签直观管理，主控强约束派发 | 输入框 `#` 菜单；支持循环审查验证、子任务级联取消与超时熔断 |
 | **🧩 原生 Skills 管理** | 全量覆盖 17 个 Harness 原生技能目录，会话启动自动预建根目录 | 设置 → Skills；支持单个 `SKILL.md` 或完整文件夹直接拖拽安装 |
@@ -144,6 +144,7 @@ Harness Mix 是接入官方 Codex Desktop 原生界面的本地内核。它通
 - **标签可视化**：已选协同 Agent 在输入框顶部呈现为胶囊标签，支持点击快速删除或 Backspace 撤销。
 - **严谨编排约束**：自动为主控 Coordinator 注入硬约束，严禁越界派发给未指定的 Harness；完善级联取消与子任务超时熔断机制。
 - **真正的 Agent Team**：一个 Lead 可组织最多六个并发的具名 Harness 成员；Team、职责、共享任务依赖图和成员邮箱均由 Host 持久化，teammate 可直接定向通信、交接和反馈，而不是只把并行结果返回 Lead。
+- **独立开关**：「设置 → 协作」中「多 Agent 协作」与「Agent Team」是两个独立开关（默认均开启）；关闭协作即同时停用团队，关闭团队则保留一次性委派。
 - **原生 Team Workbench**：对话顶部团队驾驶舱点击「展开详情」后在 Codex 内容流内显示唯一主导者、各成员职责、独立任务列、进度、通信流和事件回放，不覆盖原生侧栏、消息或输入框；成员卡片可跳转其原生子任务。状态直接向 Host 实时刷新，各成员仍使用自己的原生 Harness Session、模型、工具、权限和账户。
 - **统一 Workspace 能力**：全部 Harness 由 Host 统一获得 Git 探测、Worktree 隔离和最终快照 Diff；原生实时 Diff 继续按各 Harness 实际协议叠加。显式隔离失败不会降级到共享目录。
 
@@ -231,17 +232,6 @@ npm run e2e:codex
 
 Harness Mix 基于 [Apache License 2.0](LICENSE) 或 [MIT](LICENSE-MIT) 双许可证发布，可任选其一。第三方组件仍适用各自的许可证；归属信息见 [NOTICE](NOTICE)。
 
-## 鸣谢
-
-Harness Mix 一路走来，受了下面这些开源项目不少启发。它们都把成果公开在自己的仓库里，本项目的架构分层、协议接线和界面细节都从中获益：
-
-- BytePioneer-AI 的 Codex Desktop 集成项目（MIT）—— 官方 Codex Desktop 原生界面集成（renderer extension / desktop control / shared contracts）的衍生基础，也是整体分层与协议接线的思路来源。
-- [NanmiCoder/cc-haha](https://github.com/NanmiCoder/cc-haha) —— 多 Agent 协作运行时的编排思路来源。
-- [xintaofei/codeg](https://github.com/xintaofei/codeg) —— 工具协议与多 Harness 接线方式的参考。
-- [HeiGeAi/heige-codex-skin-studio](https://github.com/HeiGeAi/heige-codex-skin-studio) —— 皮肤市场内置皮肤素材的来源。
-
-以上项目各自适用原有许可证，归属声明与许可正文见 [NOTICE](NOTICE) 与 [licenses/](licenses/)。相关商标仍归各自所有者，本项目仅用于标识所集成的产品，不主张任何商标权、背书或关联关系。
-
 ---
 
 <a id="en"></a>
@@ -321,7 +311,7 @@ The preview comes from the current Codex Desktop native window: Harness Mix appe
 | Module | Core capabilities | Entry points & notes |
 | :--- | :--- | :--- |
 | **🔄 Cross-Harness Task Handoff** | 4 handoff modes (continue / run plan / independent review / re-analyze) with smooth transitions | Composer handoff badge / `/switch`; persisted redacted checkpoints with evidence traceability |
-| **🎨 Skin Marketplace** | Built-in HeiGe and Codex Styler themes with light / dark modes, background decorations and readability protection | Settings → Skins; one-click preview, apply and restore the stock look |
+| **🎨 Skin Marketplace** | Built-in HeiGe, Codex Styler, Dream Skin and classic editor-palette themes with light / dark modes, background decorations and readability protection | Settings → Skins; one-click preview, apply and restore the stock look |
 | **📚 History Import & Reference** | One-click import of Pi / Claude / Codex / CodeBuddy native history with interruptible resume; `#` references any past session with redacted context injected | References prefetch only the latest page; read-only MCP tools `get_session_info` / `list_session_messages` let Harnesses page through and read branch / model / usage metadata on demand |
 | **🤝 Multi-Agent Orchestration** | Type `#` to summon target Harnesses, manage them as capsule tags, dispatch under strong coordinator constraints | Composer `#` menu; loop review and verification, cascading subtask cancellation and timeout circuit breaking |
 | **🧩 Native Skills Management** | Covers the native skill directories of all 17 Harnesses, with root directories pre-created at session start | Settings → Skills; drag-and-drop install of a single `SKILL.md` or a complete folder |
@@ -388,6 +378,7 @@ One Harness analyzes in depth, another writes the implementation, then you switc
 - **Tag visualization**: selected collaborating Agents appear as capsule tags above the composer, with click-to-remove and Backspace-to-undo.
 - **Strict orchestration constraints**: the coordinator is automatically injected with hard constraints that forbid dispatching to unspecified Harnesses; cascading cancellation and subtask timeout circuit breaking are built in.
 - **Real Agent Teams**: one Lead can organize up to six concurrent named Harness members; the Team, roles, shared task dependency graph and member mailboxes are all persisted by the Host, so teammates communicate, hand off and report directly instead of only returning parallel results to the Lead.
+- **Independent switches**: Settings → Collaboration offers separate toggles for Multi-Agent Collaboration and Agent Team (both on by default); disabling collaboration also disables teams, while disabling teams keeps one-shot delegation available.
 - **Native Team Workbench**: expanding the details of the team cockpit at the top of a conversation shows the single lead, member roles, per-member task lanes, progress, message flow and event replay inside the Codex content stream — without covering the native sidebar, messages or composer. Member cards jump to their native subtasks. State refreshes live from the Host, and members keep using their own native Harness sessions, models, tools, permissions and accounts.
 - **Unified workspace capabilities**: every Harness uniformly gets Host-owned Git detection, worktree isolation and a final snapshot diff; native live diffs continue to layer on top according to each Harness's real protocol. An explicit isolation failure never degrades to a shared directory.
 
@@ -474,14 +465,3 @@ Some E2E suites launch real Harnesses and may require local installs, sign-in or
 ## License
 
 Harness Mix is dual-licensed under [Apache License 2.0](LICENSE) or [MIT](LICENSE-MIT), at your option. Third-party components remain subject to their own licenses; see [NOTICE](NOTICE) for attribution.
-
-## Acknowledgements
-
-Harness Mix owes a lot to the open-source projects below. All of them publish their work in their own repositories, and this project's architecture, protocol wiring and interface details have benefited from them:
-
-- BytePioneer-AI's Codex Desktop integration project (MIT) — the upstream basis for the native Codex Desktop integration (renderer extension, desktop control, shared contracts), and the source of its overall layering and protocol wiring.
-- [NanmiCoder/cc-haha](https://github.com/NanmiCoder/cc-haha) — the orchestration approach behind the multi-Agent collaboration runtime.
-- [xintaofei/codeg](https://github.com/xintaofei/codeg) — a reference for the tool protocol and multi-Harness wiring.
-- [HeiGeAi/heige-codex-skin-studio](https://github.com/HeiGeAi/heige-codex-skin-studio) — the artwork bundled in the skin marketplace.
-
-Each project remains subject to its own license; see [NOTICE](NOTICE) and [licenses/](licenses/) for the attribution records and upstream license texts. All trademarks remain the property of their respective owners. They are bundled solely to identify the products this project integrates with, and no trademark right, endorsement or affiliation is claimed.

package/docs/multi-agent-collaboration.md

@@ -21,7 +21,7 @@
 2. 主模型调用 `delegate_to_agent(agent_type, task)`，立即取得 `task_id`，可以继续发起其他任务。
 3. Host 创建带 `parentThreadId` 的独立原生会话。任务中需要的上下文由主模型明确传递，不复制其他 Harness 的隐藏状态、账户或权限。
 4. `update_agent_plan(steps)` 发布开发、审查、返工和最终验收计划；步骤状态为 pending / in_progress / completed。`get_delegation_status(task_ids, wait_ms)` 收取状态和最终文本；单次等待不超过 60 秒。`message_agent` 在已结束的子会话中继续对话，`cancel_delegation` 取消子任务。
-5. 结果作为真正的原生工具结果返回主模型，由主模型验证、整合并继续执行。Host 额外投影原生 `collabAgentToolCall` 协作卡片（真实子任务 ID、Harness 名称、提示词、最终状态、Worktree 补丁与改动摘要），原生桌面渲染扩展支持点击直接跳转定位到子会话、内联展开语法高亮 Diff 查看改动、以及一键合并回主项目。
+5. 结果作为真正的原生工具结果返回主模型，由主模型验证、整合并继续执行。Host 额外投影原生 `collabAgentToolCall` 协作卡片（真实子任务 ID、Harness 名称、提示词、最终状态、Worktree 补丁与改动摘要），原生桌面渲染扩展支持点击直接跳转定位到子会话、内联展开语法高亮 Diff 查看改动、以及一键合并回主项目。「创建智能体」（spawnAgent）在子会话就绪后立即结算，执行期状态由独立的 sendInput 卡片承载，桌面不会在整个执行期间停留在「创建中」。同目录并发/Agent Team 场景下，各回合的文件审查卡片只展示可归因到本会话（及其协作子会话）的改动：其他会话 Harness 上报过路径的编辑会被正向剔除，不污染本回合的 Diff 与撤回列表。
 
 `list_agents` 提供真实可用性。旧 `/delegate` 仍是独立的手动委派入口，其完成结果只回投父任务工具卡片，不自动调用父模型。
 

package/licenses/anthropic-codex-theme-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tyrion
+
+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/licenses/codex-dream-skin-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codex Dream Skin Studio contributors
+
+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.