@tt-a1i/hive 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -2,6 +2,60 @@
 
 All notable user-facing changes will be documented in this file.
 
+## 1.4.0 - 2026-05-22
+
+Template marketplace and agent picker polish.
+
+- Adds a bilingual template marketplace to the Add Member flow, with English
+  and Chinese agent libraries, category filters, search, and one-click import
+  into custom role instructions.
+- Ships the marketplace templates inside the npm package under
+  `dist/vendor/marketplace`, so the library works from packaged installs
+  without fetching remote content.
+- Polishes the marketplace drawer/card design for denser browsing, clearer
+  imported states, stronger search ergonomics, and better Chinese/English
+  category labels.
+- Keeps the Tasks side panel aligned with the Team Members panel width for a
+  more predictable two-panel layout.
+- Shows the selected CLI's brand mark in the Agent CLI picker, while keeping a
+  terminal glyph for generic custom commands.
+- Removes stale Biome suppression comments from marketplace-related UI code.
+
+## 1.3.4 - 2026-05-21
+
+Terminal performance and Tasks panel polish.
+
+- Improves terminal responsiveness by keeping mounted terminal hosts stable,
+  lazy-loading heavier xterm addons, and reducing terminal-run polling churn.
+- Fixes OpenCode TUI wheel and mouse handling by preserving binary input for
+  normal terminals while translating OpenCode legacy mouse reports into the
+  SGR format it handles correctly.
+- Sends a current `.hive/tasks.md` snapshot when a Tasks websocket connects,
+  and guards that initial read so a missing or unreadable file does not break
+  the websocket session.
+- Renames the visible Todo entry to **Tasks** and widens the Tasks side panel
+  to match the default Team Members pane width.
+- Enlarges the Team Members header and count badge for better readability.
+
+## 1.3.3 - 2026-05-21
+
+OpenCode terminal scrolling and small UI polish.
+
+- Restores the Task Graph topbar entry so the graph view is available again
+  from the main shell.
+- Updates generated worker names to use localized, role-scoped historical
+  figure name pools, making Chinese and English workspaces feel less generic.
+- Fixes OpenCode TUI mouse-wheel scrolling inside Hive terminal panels. Hive now
+  tags each terminal run with an input profile and maps OpenCode wheel events to
+  the keys OpenCode's message viewport actually handles (`Ctrl+D` / `Ctrl+U`),
+  while leaving other alternate-screen TUIs on the existing arrow-key fallback.
+- Preserves that OpenCode profile when the user selects the OpenCode preset but
+  starts it through a custom startup command such as `opencode --continue`.
+- Keeps workspace shell terminals on the default input profile.
+- Enlarges the Team Members header count for better readability.
+- Documents that npm's `prebuild-install@7.1.3` deprecation warning comes from
+  the upstream native-binary installer chain and is safe to ignore.
+
 ## 1.3.0 - 2026-05-20
 
 Installable Hive: turns the web shell into a real PWA so Chrome / Edge can
@@ -135,37 +189,30 @@ Brand polish.
 
 ## 1.1.2 - 2026-05-17
 
-Private-release workflow fix.
+Release workflow fix.
 
 - Runs npm publish on Ubuntu instead of macOS. Publishing does not require
-  macOS, and the Ubuntu runner avoids unnecessary private-repo Actions cost.
+  macOS, and the Ubuntu runner is a better fit for the publish step.
 
 ## 1.1.1 - 2026-05-17
 
-Private-release workflow fix.
+Release workflow fix.
 
-- Publishes from the private product repository without npm provenance because
-  npm provenance currently requires a public GitHub Actions source repository.
-  The package contents are otherwise the same 1.1.x private-release line:
-  Workspace terminal tabs, hidden dormant Blueprint entry, and no production
-  source maps in the npm tarball.
+- Publishes without production source maps in the npm tarball while keeping the
+  user-facing package contents unchanged.
 
 ## 1.1.0 - 2026-05-17
 
-Private-release line.
+Workspace terminal release.
 
 - Added a Workspace terminal that opens from the active workspace and runs in
   the workspace directory. It supports multiple shell tabs, full-height terminal
   space, tab switching, and closing individual tabs without closing the whole
   dialog.
 - Kept the external install path unchanged. Users still install with
-  `npm install -g @tt-a1i/hive` or run with `npx @tt-a1i/hive`; this release is
-  built from the private product repository and published to the same npm
-  package.
+  `npm install -g @tt-a1i/hive` or run with `npx @tt-a1i/hive`.
 - Hid the dormant task-graph / Blueprint entry from the main UI while keeping
   the underlying code in place for possible future use.
-- Documented the public/private repository split and release policy in
-  `docs/private-release-strategy.md`.
 
 ## 1.0.0 - 2026-05-17
 

package/README.en.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="./assets/logo.png" width="120" alt="Hive logo" />
+</p>
+
 # Hive
 
 <p align="center">
@@ -15,12 +19,12 @@ Code, research, drafts, translations — if a team can split the work, a hive ca
 
 [![npm](https://img.shields.io/npm/v/@tt-a1i/hive.svg)](https://www.npmjs.com/package/@tt-a1i/hive)
 [![ci](https://img.shields.io/github/actions/workflow/status/tt-a1i/hive/release.yml?branch=main&label=ci)](https://github.com/tt-a1i/hive/actions/workflows/release.yml)
-[![Website](https://img.shields.io/badge/website-hive--site.pages.dev-5a8a8a.svg)](https://hive-site.pages.dev)
+[![Website](https://img.shields.io/badge/website-hivehq.dev-5a8a8a.svg)](https://hivehq.dev)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-3c873a.svg)](https://nodejs.org/)
 [![License](https://img.shields.io/badge/license-BUSL--1.1-orange.svg)](./LICENSE.BSL)
 [![Platforms](https://img.shields.io/badge/platforms-macOS%20%C2%B7%20Linux%20%C2%B7%20Windows%20(best--effort)-lightgrey.svg)](#platform-support)
 
-🌐 **Website**: [hive-site.pages.dev/en/](https://hive-site.pages.dev/en/) · [中文](https://hive-site.pages.dev/)
+🌐 **Website**: [hivehq.dev/en/](https://hivehq.dev/en/) · [中文](https://hivehq.dev/)
 
 English · [简体中文](./README.md)
 
@@ -29,6 +33,10 @@ English · [简体中文](./README.md)
 > [npm](https://www.npmjs.com/package/@tt-a1i/hive) and the badge above resolves
 > to it.
 
+<p align="center">
+  <img src="./assets/hive-team-view.png" alt="Hive workbench with a 4-agent team — orchestrator dispatching while workers run" />
+</p>
+
 ## Why Hive
 
 CLI agents are powerful, but coordinating several of them manually is
@@ -236,6 +244,11 @@ Hive depends on `node-pty` and `better-sqlite3`, which use native binaries. Use
 Node.js 22+, keep your package manager cache clean, and verify your platform
 build tools are available.
 
+If npm prints a deprecated warning for `prebuild-install@7.1.3`, it is safe to
+ignore. The warning comes from `better-sqlite3`'s native binary download chain;
+it is an upstream installer maintenance notice, not a Hive install failure, and
+does not affect runtime behavior.
+
 **Folder picker does not open on Linux**
 
 Install `zenity`, or paste the workspace path manually.
@@ -300,12 +313,56 @@ verifies macOS, Ubuntu, and Windows, then publishes to npm with `NPM_TOKEN`.
 
 ## Status
 
-Hive is published as a stable release. Current work focuses on polishing the
-multi-agent collaboration workflow, Windows support, and clearer orchestration
-observability.
+Hive is in alpha. The core flow is usable today; current work focuses on
+polishing the multi-agent collaboration workflow, Windows support, and clearer
+orchestration observability. Try it out and open issues — feedback shapes what
+gets prioritized next.
 
-## License
+## On the roadmap: cross-agent long-term memory
+
+<p align="center">
+  <a href="https://github.com/EverMind-AI/EverOS">
+    <img src="https://avatars.githubusercontent.com/EverMind-AI" width="72" alt="EverMind / EverOS" />
+  </a>
+</p>
+
+Single-agent memory already exists, but the styles diverge:
 
-Hive is licensed under the Business Source License 1.1 (see [LICENSE.BSL](LICENSE.BSL)). BSL permits personal use, internal deployment, embedding in non-competitive products, and non-commercial forks; it **only prohibits** offering Hive as a hosted multi-agent orchestration service to third parties.
+- **Claude Code's [Auto Dream](https://claudefa.st/blog/guide/mechanics/auto-dream)** is **batch / offline** — invoked via `/dream` (or on a 24h timer), Claude consolidates JSONL session logs in the cloud, merges duplicates, extracts patterns, and proposes a new memory file for you to review and adopt. REM-sleep style, with a clean wake/sleep separation.
+- **Hermes Agent** runs the opposite playbook — **embedded and in-stride**. Every N turns it forks a background sub-agent to review the recent exchange and writes directly into a **multi-organ local store**: `MEMORY.md` (facts/rules) · `USER.md` (who-you-are) · SQLite + FTS5 (episodic search) · Honcho (third-person model) · `skills/` (procedural memory). The agent is allowed to edit its own skill files in stride — memory and capability are the same thing.
+
+But these are all **per-agent** memories. Hive coordinates *teams* of agents, so the next step is wiring them together: let the whole team **share one long-term memory store** — what Worker A learned today becomes context the Orchestrator can dispatch to Worker B tomorrow.
+
+We're planning to back this with **[EverOS](https://github.com/EverMind-AI/EverOS)**
+— an open-source long-term memory OS from [EverMind](https://evermind.ai/),
+currently SOTA on the LoCoMo / LongMemEval / HaluMem memory benchmarks.
+Its four-layer architecture (Agentic / Memory / Index / API+MCP) maps
+cleanly onto Hive's multi-PTY model: each agent keeps its in-CLI memory,
+team-level facts flow through EverOS, and the Orchestrator joins both
+when dispatching.
+
+Track progress at [#6](https://github.com/tt-a1i/hive/issues/6) — drop a
++1 or comment with your use case to influence priority.
+
+## A different form factor: squad
+
+If you'd rather have **pure CLI, zero background process, and the ability to
+run on a remote SSH box**, [squad](https://github.com/mco-org/squad) takes the
+same idea down a different path — SQLite as the protocol layer, one terminal
+per agent. The two projects don't replace each other; pick by workflow:
+
+- **Hive** — visual workbench, one-click restart, workspace sidebar, easier to demo to a team
+- **squad** — lives in tmux, SSH remote dev, no extra background process, Windows servers
+
+## Acknowledgements
+
+The built-in template marketplace ships snapshots of two community-maintained prompt libraries, both distributed under their upstream MIT licenses:
+
+- English (used when the UI is set to EN): [`msitarzewski/agency-agents`](https://github.com/msitarzewski/agency-agents)
+- Chinese (used when the UI is set to 中文): [`jnMetaCode/agency-agents-zh`](https://github.com/jnMetaCode/agency-agents-zh)
+
+Upstream content is mirrored verbatim, license files are kept under `vendor/marketplace/<lang>/LICENSE`, and snapshots are refreshed by `pnpm sync:marketplace` before each Hive release.
+
+## License
 
-See the Additional Use Grant in [LICENSE.BSL](LICENSE.BSL) for the exact boundary.
+Hive is open source under the Business Source License 1.1. Personal use, internal deployment, embedding, and forks are permitted — see [LICENSE.BSL](LICENSE.BSL) for the exact boundary.

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="./assets/logo.png" width="120" alt="Hive logo" />
+</p>
+
 # Hive
 
 <p align="center">
@@ -10,17 +14,21 @@
 
 [![npm](https://img.shields.io/npm/v/@tt-a1i/hive.svg)](https://www.npmjs.com/package/@tt-a1i/hive)
 [![ci](https://img.shields.io/github/actions/workflow/status/tt-a1i/hive/release.yml?branch=main&label=ci)](https://github.com/tt-a1i/hive/actions/workflows/release.yml)
-[![Website](https://img.shields.io/badge/website-hive--site.pages.dev-5a8a8a.svg)](https://hive-site.pages.dev)
+[![Website](https://img.shields.io/badge/website-hivehq.dev-5a8a8a.svg)](https://hivehq.dev)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-3c873a.svg)](https://nodejs.org/)
 [![License](https://img.shields.io/badge/license-BUSL--1.1-orange.svg)](./LICENSE.BSL)
 [![Platforms](https://img.shields.io/badge/platforms-macOS%20%C2%B7%20Linux%20%C2%B7%20Windows%20(best--effort)-lightgrey.svg)](#平台支持)
 
-🌐 **官网**：[hive-site.pages.dev](https://hive-site.pages.dev/)（[English](https://hive-site.pages.dev/en/)）
+🌐 **官网**：[hivehq.dev](https://hivehq.dev/)（[English](https://hivehq.dev/en/)）
 
 [English](./README.en.md) · 简体中文
 
 > Hive 是本机优先的工具，只监听 `127.0.0.1`，面向已经在用 CLI Agent 的人。最新稳定版本见 [npm](https://www.npmjs.com/package/@tt-a1i/hive)，上面的 badge 会指向它。
 
+<p align="center">
+  <img src="./assets/hive-team-view.png" alt="Hive 工作台：4 个 CLI Agent 团队，Orchestrator 派单、Worker 各自开工" />
+</p>
+
 ## 为什么需要 Hive
 
 CLI Agent 各自都很强，但同时管几个就有点别扭：
@@ -173,6 +181,8 @@ hive --port 4020
 
 Hive 依赖 `node-pty` 和 `better-sqlite3`，它们用原生二进制。确认 Node.js 22+，清干净 package manager 缓存，并准备好你平台的构建工具（macOS Xcode CLI、Linux build-essential + python3、Windows VS Build Tools）。
 
+安装时如果看到 `prebuild-install@7.1.3` 的 deprecated warning，可以忽略。它来自 `better-sqlite3` 的原生二进制下载链路，只是上游安装器维护状态提示，不代表 Hive 安装失败，也不会影响运行。
+
 **Linux 上目录选择器不弹**
 
 装 `zenity`，或者直接在对话框里粘路径。
@@ -229,10 +239,43 @@ pnpm release:dry
 
 ## 状态
 
-Hive 已发布稳定版。当前重点是继续打磨多 Agent 协作体验、Windows 支持和更清晰的调度可观测性。
+Hive 目前处于 alpha 阶段，核心流程已可用。当前重点是继续打磨多 Agent 协作体验、Windows 支持和更清晰的调度可观测性。欢迎试用、提 issue——反馈会直接影响后续节奏。
 
-## License
+## 在路上：跨 Agent 的长时记忆
+
+<p align="center">
+  <a href="https://github.com/EverMind-AI/EverOS">
+    <img src="https://avatars.githubusercontent.com/EverMind-AI" width="72" alt="EverMind / EverOS" />
+  </a>
+</p>
+
+单 agent 现在已经各有各的"记忆"了——但风格其实差很多：
 
-Hive 使用 Business Source License 1.1（[LICENSE.BSL](LICENSE.BSL)）。BSL 允许个人使用、内部部署、嵌入其他产品、非商业 fork；**仅禁止**把 Hive 包装成多 agent 协作 SaaS 卖给第三方。
+- **Claude Code 的 [Auto Dream](https://claudefa.st/blog/guide/mechanics/auto-dream)（俗称"做梦"）** 走 **离线批处理** 路线：`/dream` 触发（或 24h 自动），Claude 在云端把 JSONL 会话归并去重抽模式，产出新版本 memory 库给你审查再采纳——像人类的 REM 睡眠，**清醒 / 睡眠二相**。
+- **Hermes Agent** 反过来走 **嵌入式 / 在场** 路线：不睡，每 N 轮对话后台 fork 一个 sub-agent review，结果直接落进本地的 **多层记忆**——`MEMORY.md`（事实/规则）·`USER.md`（用户画像）·SQLite + FTS5（情景检索）·Honcho（第三人称表征）·`skills/`（程序性记忆）——而且 agent 允许边走边改自己的 skill 文件，记忆和能力是一回事。
+
+但 **这些都是单 agent 内部的记忆**。Hive 是多 agent 协作工作台，下一步要做的事是把它们打通：让整支团队 **共享一座长时记忆库**——Worker A 今天踩的坑，明天 Orchestrator 派给 Worker B 时能自动调来当上下文。
+
+底层我们计划接 **[EverOS](https://github.com/EverMind-AI/EverOS)**（[EverMind](https://evermind.ai/) 出品的开源长时记忆 OS，目前在 LoCoMo / LongMemEval / HaluMem 三个记忆 benchmark 上 SOTA）当跨 agent 的记忆后端。它的四层架构（Agentic / Memory / Index / API+MCP）跟 Hive 的多 PTY 协作模型很搭：每个 agent 各跑各的 CLI session，团队级的事实和模式凝在 EverOS，Orchestrator 派单时一并喂给 worker。
+
+进度跟踪：[#6](https://github.com/tt-a1i/hive/issues/6)——想看进度或提建议，在 issue 留 +1。
+
+## 另一种形态：squad
+
+如果你更喜欢 **纯 CLI、零后台进程、能直接在 SSH 进的远端服务器上跑** 的形态，[squad](https://github.com/mco-org/squad) 是同一个想法的另一条路线——SQLite 当通信层，每个 agent 各自开一个终端。两个项目互不替代，按工作流挑就行：
+
+- **Hive** — 想要可视化工作台、一键重启、侧边栏切 workspace、给团队演示
+- **squad** — 活在 tmux 里、SSH 远端开发、不想跑额外后台进程、Windows server
+
+## 鸣谢
+
+Hive 的"模板市场"内置了两份社区角色 prompt 库的快照，两份都按各自上游的 MIT 许可分发：
+
+- 英文版（界面切到 EN 时使用）：[`msitarzewski/agency-agents`](https://github.com/msitarzewski/agency-agents)
+- 中文版（界面切到中文时使用）：[`jnMetaCode/agency-agents-zh`](https://github.com/jnMetaCode/agency-agents-zh)
+
+上游内容未做修改，许可证文本保留在 `vendor/marketplace/<lang>/LICENSE`；快照通过 `pnpm sync:marketplace` 在 hive 发版前刷新。
+
+## License
 
-详细边界见 [LICENSE.BSL](LICENSE.BSL) 的 Additional Use Grant。
+Hive 在 Business Source License 1.1 下开源。个人使用、内部部署、嵌入、fork 都可以；详细边界见 [LICENSE.BSL](LICENSE.BSL)。

package/dist/src/cli/hive.js

@@ -65,6 +65,26 @@ const maybePrintUpdateHint = async (versionService) => {
         return;
     console.log(`Hive update available: ${info.current_version} -> ${info.latest_version}. Run: ${info.install_hint}`);
 };
+const isListenError = (error) => error instanceof Error && typeof error.code === 'string';
+const formatPortInUseMessage = (port) => [
+    `Hive could not start because port ${port} is already in use.`,
+    '',
+    'Another Hive instance may already be running:',
+    `  http://127.0.0.1:${port}`,
+    '',
+    'Options:',
+    '  - Open the existing Hive window.',
+    '  - Stop the process using that port:',
+    `      lsof -tiTCP:${port} -sTCP:LISTEN | xargs kill`,
+    '  - Start Hive on another port:',
+    `      hive --port ${port + 1}`,
+].join('\n');
+const formatListenError = (error, requestedPort) => {
+    if (isListenError(error) && error.code === 'EADDRINUSE') {
+        return new Error(formatPortInUseMessage(error.port ?? requestedPort));
+    }
+    return error;
+};
 export const runHiveCommand = async (argv, options = {}) => {
     const port = parsePort(argv);
     const dataDir = resolveDataDir();
@@ -76,13 +96,19 @@ export const runHiveCommand = async (argv, options = {}) => {
         }),
         versionService,
     });
-    app.server.listen(port, '127.0.0.1');
-    await Promise.race([
-        once(app.server, 'listening'),
-        once(app.server, 'error').then(([error]) => {
-            throw error;
-        }),
-    ]);
+    try {
+        app.server.listen(port, '127.0.0.1');
+        await Promise.race([
+            once(app.server, 'listening'),
+            once(app.server, 'error').then(([error]) => {
+                throw error;
+            }),
+        ]);
+    }
+    catch (error) {
+        await app.store.close();
+        throw formatListenError(error, port);
+    }
     const address = app.server.address();
     if (!address || typeof address === 'string') {
         throw new Error('Server did not bind to an inet port');
@@ -146,7 +172,7 @@ if (isMainModule) {
     }
     else {
         runHiveCommand(argv).catch((error) => {
-            console.error(error);
+            console.error(error instanceof Error ? error.message : error);
             process.exit(1);
         });
     }

package/dist/src/cli/team.d.ts

@@ -1,3 +1,7 @@
+interface ParsedCancelArgs {
+    dispatchId: string;
+    reason: string;
+}
 export interface ParsedReportArgs {
     artifacts: string[];
     dispatchId: string | undefined;
@@ -5,5 +9,7 @@ export interface ParsedReportArgs {
     useStdin: boolean;
 }
 export declare const parseReportArgs: (args: string[], command?: string) => ParsedReportArgs;
+export declare const parseCancelArgs: (args: string[]) => ParsedCancelArgs;
 export declare const readStdinToString: (command?: string) => Promise<string>;
 export declare const runTeamCommand: (argv: string[]) => Promise<void>;
+export {};

package/dist/src/cli/team.js

@@ -10,6 +10,7 @@ const TEAM_USAGE = [
     'Usage:',
     '  team list',
     '  team send <worker-name> "<task>"',
+    '  team cancel --dispatch <dispatch-id> "<reason>"',
     '  team report "<result>" [--dispatch <dispatch-id>] [--artifact <path>]',
     '  team report --stdin [--dispatch <dispatch-id>] [--artifact <path>]',
     '  team status "<current status>" [--artifact <path>]',
@@ -80,6 +81,7 @@ const postJson = async (baseUrl, path, body) => {
 };
 const REPORT_USAGE = 'Usage: team report (<result> | --stdin) [--dispatch <dispatch-id>] [--artifact <path>]';
 const STATUS_USAGE = 'Usage: team status (<current status> | --stdin) [--artifact <path>]';
+const CANCEL_USAGE = 'Usage: team cancel --dispatch <dispatch-id> <reason>';
 const usageFor = (command) => (command === 'status' ? STATUS_USAGE : REPORT_USAGE);
 const withUsage = (message, command) => `${message}\n\n${usageFor(command)}`;
 export const parseReportArgs = (args, command = 'report') => {
@@ -139,6 +141,39 @@ export const parseReportArgs = (args, command = 'report') => {
     }
     return { result: useStdin ? null : (positionals[0] ?? null), artifacts, dispatchId, useStdin };
 };
+export const parseCancelArgs = (args) => {
+    const positionals = [];
+    let dispatchId;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === undefined)
+            continue;
+        if (arg === '--dispatch') {
+            const next = args[index + 1];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error(`--dispatch requires a value\n\n${CANCEL_USAGE}`);
+            }
+            dispatchId = next;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            throw new Error(`Unknown argument: ${arg}\n\n${CANCEL_USAGE}`);
+        }
+        positionals.push(arg);
+    }
+    if (!dispatchId) {
+        throw new Error(`Missing --dispatch <dispatch-id>\n\n${CANCEL_USAGE}`);
+    }
+    if (positionals.length === 0) {
+        throw new Error(`Missing <reason>\n\n${CANCEL_USAGE}`);
+    }
+    const reason = positionals.join(' ').trim();
+    if (!reason) {
+        throw new Error(`Missing <reason>\n\n${CANCEL_USAGE}`);
+    }
+    return { dispatchId, reason };
+};
 export const readStdinToString = async (command = 'report') => {
     if (process.stdin.isTTY) {
         throw new Error(withUsage('--stdin requires piped input, but stdin is a TTY. Did you forget to pipe content in?', command));
@@ -194,6 +229,19 @@ export const runTeamCommand = async (argv) => {
         console.log(JSON.stringify(await response.json()));
         return;
     }
+    if (command === 'cancel') {
+        const cancel = parseCancelArgs(args);
+        const env = getHiveEnv();
+        const baseUrl = getBaseUrl(env);
+        await postJson(baseUrl, '/api/team/cancel', {
+            dispatch_id: cancel.dispatchId,
+            project_id: env.HIVE_PROJECT_ID,
+            from_agent_id: env.HIVE_AGENT_ID,
+            token: env.HIVE_AGENT_TOKEN,
+            reason: cancel.reason,
+        });
+        return;
+    }
     if (command === 'status') {
         const report = parseReportArgs(args, 'status');
         const body = report.useStdin ? await readStdinToString('status') : (report.result ?? '');

package/dist/src/server/agent-launch-cache.js

@@ -1,8 +1,11 @@
 export const createAgentLaunchCache = (store) => {
     const launchConfigs = new Map();
     const workspaceByAgentId = new Map();
+    const missingLaunchConfigs = new Set();
     const cacheKey = (workspaceId, agentId) => `${workspaceId}:${agentId}`;
     const load = () => {
+        launchConfigs.clear();
+        workspaceByAgentId.clear();
         for (const row of store.listLaunchConfigs()) {
             launchConfigs.set(cacheKey(row.workspaceId, row.agentId), row.config);
             workspaceByAgentId.set(row.agentId, row.workspaceId);
@@ -11,21 +14,33 @@ export const createAgentLaunchCache = (store) => {
     load();
     return {
         get(workspaceId, agentId) {
-            const config = launchConfigs.get(cacheKey(workspaceId, agentId));
+            const key = cacheKey(workspaceId, agentId);
+            const config = launchConfigs.get(key);
             if (config)
                 return config;
+            if (missingLaunchConfigs.has(key)) {
+                throw new Error(`Agent launch config not found: ${agentId}`);
+            }
             load();
-            const reloadedConfig = launchConfigs.get(cacheKey(workspaceId, agentId));
+            const reloadedConfig = launchConfigs.get(key);
             if (reloadedConfig)
                 return reloadedConfig;
+            missingLaunchConfigs.add(key);
             throw new Error(`Agent launch config not found: ${agentId}`);
         },
         peek(workspaceId, agentId) {
-            const config = launchConfigs.get(cacheKey(workspaceId, agentId));
+            const key = cacheKey(workspaceId, agentId);
+            const config = launchConfigs.get(key);
             if (config)
                 return config;
+            if (missingLaunchConfigs.has(key))
+                return undefined;
             load();
-            return launchConfigs.get(cacheKey(workspaceId, agentId));
+            const reloadedConfig = launchConfigs.get(key);
+            if (reloadedConfig)
+                return reloadedConfig;
+            missingLaunchConfigs.add(key);
+            return undefined;
         },
         getWorkspaceId(agentId) {
             return workspaceByAgentId.get(agentId);
@@ -41,12 +56,16 @@ export const createAgentLaunchCache = (store) => {
                 sessionIdCapture: input.sessionIdCapture ?? null,
             };
             store.saveLaunchConfig(workspaceId, agentId, normalized);
-            launchConfigs.set(cacheKey(workspaceId, agentId), normalized);
+            const key = cacheKey(workspaceId, agentId);
+            launchConfigs.set(key, normalized);
+            missingLaunchConfigs.delete(key);
             workspaceByAgentId.set(agentId, workspaceId);
         },
         remove(workspaceId, agentId) {
             store.deleteLaunchConfig(workspaceId, agentId);
-            launchConfigs.delete(cacheKey(workspaceId, agentId));
+            const key = cacheKey(workspaceId, agentId);
+            launchConfigs.delete(key);
+            missingLaunchConfigs.add(key);
             workspaceByAgentId.delete(agentId);
         },
         setWorkspaceId(agentId, workspaceId) {

package/dist/src/server/agent-manager.d.ts

@@ -27,7 +27,7 @@ interface AgentRunRecord extends AgentRunSnapshot {
         resize: (cols: number, rows: number) => void;
         resume: () => void;
         stop: () => void;
-        write: (text: string) => void;
+        write: (input: Buffer | string) => void;
     };
     onExit?: (event: {
         runId: string;
@@ -40,7 +40,7 @@ interface AgentManager {
     resizeRun: (runId: string, cols: number, rows: number) => void;
     resumeRun: (runId: string) => void;
     startAgent: (input: StartAgentInput) => Promise<AgentRunSnapshot>;
-    writeInput: (runId: string, text: string) => void;
+    writeInput: (runId: string, input: Buffer | string) => void;
     getRun: (runId: string) => AgentRunSnapshot;
     removeRun: (runId: string) => void;
     stopRun: (runId: string) => void;

package/dist/src/server/agent-runtime-contract.d.ts

@@ -29,6 +29,9 @@ export interface AgentRuntime {
         requireActiveRun?: boolean;
     }) => void;
     writeSendPrompt: (workspaceId: string, workerId: string, dispatchId: string, fromAgentName: string, workerDescription: string, text: string) => void;
+    writeCancelPrompt: (workspaceId: string, workerId: string, dispatchId: string, reason: string, input?: {
+        requireActiveRun?: boolean;
+    }) => void;
     writeUserInputPrompt: (workspaceId: string, text: string) => void;
 }
 export type { StartAgentOptions };

package/dist/src/server/agent-runtime.js

@@ -115,6 +115,9 @@ export const createAgentRuntime = (agentManager, agentRunStore, sessionStore, ge
         writeSendPrompt(workspaceId, workerId, dispatchId, fromAgentName, workerDescription, text) {
             stdinDispatcher.writeSendPrompt(workspaceId, workerId, dispatchId, fromAgentName, workerDescription, text);
         },
+        writeCancelPrompt(workspaceId, workerId, dispatchId, reason, input = {}) {
+            stdinDispatcher.writeCancelPrompt(workspaceId, workerId, dispatchId, reason, input);
+        },
         writeUserInputPrompt(workspaceId, text) {
             stdinDispatcher.writeUserInputPrompt(workspaceId, text);
         },

package/dist/src/server/agent-startup-instructions.js

@@ -15,7 +15,7 @@ export const buildAgentStartupInstructions = ({ agent, workspace, }) => {
         '',
     ];
     if (agent.role === 'orchestrator') {
-        lines.push('你的职责：', '- 直接响应 user，澄清需求并拆解任务', `- 维护 ${TASKS_RELATIVE_PATH}`, '- 按 worker 名称派单，并根据汇报推进下一步', '', '可用 team 命令：', '- team list', '- team send <worker-name> "<task>"', '', '派单时必须使用 worker name，不要使用 worker id。', '', 'Hive worker 派单规则：', ...getHiveTeamRules(agent));
+        lines.push('你的职责：', '- 直接响应 user，澄清需求并拆解任务', `- 维护 ${TASKS_RELATIVE_PATH}`, '- 按 worker 名称派单，并根据汇报推进下一步', '', '可用 team 命令：', '- team list', '- team send <worker-name> "<task>"', '- team cancel --dispatch <id> "<reason>"', '', '派单时必须使用 worker name，不要使用 worker id。', '取消未完成派单时必须使用 dispatch id。', '', 'Hive worker 派单规则：', ...getHiveTeamRules(agent));
     }
     else {
         lines.push('可用 team 命令：', '- team report "<完整汇报>" [--dispatch <id>] [--artifact <path>]    完成/失败/阻塞汇报', '- team report --stdin [--dispatch <id>] [--artifact <path>]         同上，从 stdin 读正文（适合多行/含引号/特殊字符）', '- team status "<当前状态>" [--artifact <path>]                       中段进度/待命/接入状态', '- team status --stdin [--artifact <path>]                          同上，从 stdin 读正文', '- team list                                                        查看 workspace 内的 worker（含状态）', '- team --help                                                      仅查命令用法；**不是**汇报手段', '', '语法要点：', '- 正文是第一个 positional argument，flag 顺序任意：`team report "结论" --dispatch X` 和 `team report --dispatch X "结论"` 都成立。', "- 长正文（多行 / 含引号 / shell 特殊字符 / heredoc）一律走 `--stdin`，并用 *quoted* heredoc（`<<'EOF'`）防止 shell 展开 $vars / 反引号 / 命令替换：", "  例：`team report --stdin --dispatch <id> <<'EOF'`", '       `... 长报告（含 $VAR、`backtick`、"引号" 都按字面量保留）...`', '       `EOF`', '- CLI 报错会同时打印 USAGE，可直接对照修正参数。', '', '完成任务后必须执行 `team report "<结论>"`。', '失败、阻塞或部分完成也用 `team report "<当前状态与原因>"` 汇报。', '没有进行中的任务时，用 `team status "<当前状态>"` 汇报接入、待命或阻塞状态。', '不要调用 team send；worker 之间不能直接派单。', '', 'Hive worker 边界：', ...getHiveTeamRules(agent));

package/dist/src/server/agent-stdin-dispatcher.d.ts

@@ -13,6 +13,7 @@ export declare const buildOrchestratorReportPayload: (workerName: string, text:
 export declare const buildOrchestratorStatusPayload: (workerName: string, text: string, artifacts: string[]) => string;
 export declare const buildOrchestratorUserInputPayload: (text: string) => string;
 export declare const buildWorkerDispatchPayload: (fromAgentName: string, workerDescription: string, dispatchId: string, text: string) => string;
+export declare const buildWorkerCancelPayload: (dispatchId: string, reason: string) => string;
 export declare const createAgentStdinDispatcher: ({ agentManager, getLaunchConfig, getWorkspaceId, registry, syncRun, }: AgentStdinDispatcherInput) => {
     writeReportPrompt(workspaceId: string, workerName: string, text: string, artifacts: string[], input?: {
         requireActiveRun?: boolean;
@@ -21,6 +22,9 @@ export declare const createAgentStdinDispatcher: ({ agentManager, getLaunchConfi
         requireActiveRun?: boolean;
     }): void;
     writeSendPrompt(workspaceId: string, workerId: string, dispatchId: string, fromAgentName: string, workerDescription: string, text: string): void;
+    writeCancelPrompt(workspaceId: string, workerId: string, dispatchId: string, reason: string, input?: {
+        requireActiveRun?: boolean;
+    }): void;
     writeUserInputPrompt(workspaceId: string, text: string): void;
 };
 export {};

package/dist/src/server/agent-stdin-dispatcher.js

@@ -33,6 +33,15 @@ export const buildWorkerDispatchPayload = (fromAgentName, workerDescription, dis
     buildWorkerReminderTail(dispatchId),
     '',
 ].join('\n');
+export const buildWorkerCancelPayload = (dispatchId, reason) => [
+    `[Hive 系统消息：dispatch ${dispatchId} 已取消]`,
+    '',
+    '请停止执行这条派单，不要再为它调用 team report。',
+    '',
+    '取消原因：',
+    reason,
+    '',
+].join('\n');
 export const createAgentStdinDispatcher = ({ agentManager, getLaunchConfig, getWorkspaceId, registry, syncRun, }) => {
     const writeToActiveAgentRun = (workspaceId, agentId, text, input = {}) => {
         const run = registry
@@ -72,6 +81,9 @@ export const createAgentStdinDispatcher = ({ agentManager, getLaunchConfig, getW
         writeSendPrompt(workspaceId, workerId, dispatchId, fromAgentName, workerDescription, text) {
             writeToActiveAgentRun(workspaceId, workerId, buildWorkerDispatchPayload(fromAgentName, workerDescription, dispatchId, text), { requireActiveRun: true });
         },
+        writeCancelPrompt(workspaceId, workerId, dispatchId, reason, input = {}) {
+            writeToActiveAgentRun(workspaceId, workerId, buildWorkerCancelPayload(dispatchId, reason), input);
+        },
         writeUserInputPrompt(workspaceId, text) {
             writeToActiveAgentRun(workspaceId, `${workspaceId}:orchestrator`, buildOrchestratorUserInputPayload(text));
         },

package/dist/src/server/app.js

@@ -129,6 +129,6 @@ export const createApp = ({ store, pickFolderService = pickFolder, openWorkspace
             sendJson(response, 500, { error: message });
         }
     });
-    createTerminalWebSocketServer(server, store);
+    createTerminalWebSocketServer(server, store, tasksFileService);
     return { server, store };
 };