@tt-a1i/hive 1.3.0 → 1.3.4

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 All notable user-facing changes will be documented in this file.
 
+## 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 +170,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,21 @@ 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
+## 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 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.
+- **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
+
+## 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,15 @@ pnpm release:dry
 
 ## 状态
 
-Hive 已发布稳定版。当前重点是继续打磨多 Agent 协作体验、Windows 支持和更清晰的调度可观测性。
+Hive 目前处于 alpha 阶段，核心流程已可用。当前重点是继续打磨多 Agent 协作体验、Windows 支持和更清晰的调度可观测性。欢迎试用、提 issue——反馈会直接影响后续节奏。
 
-## License
+## 另一种形态：squad
+
+如果你更喜欢 **纯 CLI、零后台进程、能直接在 SSH 进的远端服务器上跑** 的形态，[squad](https://github.com/mco-org/squad) 是同一个想法的另一条路线——SQLite 当通信层，每个 agent 各自开一个终端。两个项目互不替代，按工作流挑就行：
 
-Hive 使用 Business Source License 1.1（[LICENSE.BSL](LICENSE.BSL)）。BSL 允许个人使用、内部部署、嵌入其他产品、非商业 fork；**仅禁止**把 Hive 包装成多 agent 协作 SaaS 卖给第三方。
+- **Hive** — 想要可视化工作台、一键重启、侧边栏切 workspace、给团队演示
+- **squad** — 活在 tmux 里、SSH 远端开发、不想跑额外后台进程、Windows server
+
+## License
 
-详细边界见 [LICENSE.BSL](LICENSE.BSL) 的 Additional Use Grant。
+Hive 在 Business Source License 1.1 下开源。个人使用、内部部署、嵌入、fork 都可以；详细边界见 [LICENSE.BSL](LICENSE.BSL)。

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 };
 };

package/dist/src/server/dispatch-ledger-store.d.ts

@@ -1,5 +1,5 @@
 import type { Database } from 'better-sqlite3';
-export type DispatchStatus = 'queued' | 'submitted' | 'reported';
+export type DispatchStatus = 'queued' | 'submitted' | 'reported' | 'cancelled';
 export interface DispatchRecord {
     artifacts: string[];
     createdAt: number;
@@ -28,6 +28,11 @@ interface ReportDispatchInput {
     toAgentId: string;
     workspaceId: string;
 }
+interface CancelDispatchInput {
+    dispatchId: string;
+    reason: string;
+    workspaceId: string;
+}
 export interface ListDispatchesOptions {
     limit?: number;
     offset?: number;
@@ -39,12 +44,28 @@ export declare const createDispatchLedgerStore: (db: Database) => {
     deleteWorkerDispatches: (workspaceId: string, workerId: string) => void;
     deleteWorkspaceDispatches: (workspaceId: string) => void;
     findOpenDispatch: (workspaceId: string, toAgentId: string, dispatchId?: string) => DispatchRecord | undefined;
+    findOpenDispatchById: (workspaceId: string, dispatchId: string) => DispatchRecord | undefined;
     listOpenDispatchKinds: () => Array<{
         type: "send";
         worker_id: string;
         workspace_id: string;
     }>;
     listWorkspaceDispatches: (workspaceId: string, options?: ListDispatchesOptions) => DispatchRecord[];
+    markCancelled: (input: CancelDispatchInput) => {
+        reportedAt: number;
+        reportText: string;
+        status: "cancelled";
+        artifacts: string[];
+        createdAt: number;
+        deliveredAt: number | null;
+        fromAgentId: string | null;
+        id: string;
+        sequence: number | null;
+        submittedAt: number | null;
+        text: string;
+        toAgentId: string;
+        workspaceId: string;
+    } | undefined;
     markReportedByWorker: (input: ReportDispatchInput) => {
         artifacts: string[];
         reportedAt: number;

package/dist/src/server/dispatch-ledger-store.js

@@ -77,7 +77,7 @@ export const createDispatchLedgerStore = (db) => {
            WHERE id = ?
              AND workspace_id = ?
              AND to_agent_id = ?
-             AND status != 'reported'
+             AND status IN ('queued', 'submitted')
            LIMIT 1`)
                 .get(dispatchId, workspaceId, toAgentId);
             return row ? toRecord(row) : undefined;
@@ -87,12 +87,23 @@ export const createDispatchLedgerStore = (db) => {
          FROM dispatches
          WHERE workspace_id = ?
            AND to_agent_id = ?
-           AND status != 'reported'
+           AND status IN ('queued', 'submitted')
          ORDER BY sequence ASC
          LIMIT 1`)
             .get(workspaceId, toAgentId);
         return row ? toRecord(row) : undefined;
     };
+    const findOpenDispatchById = (workspaceId, dispatchId) => {
+        const row = db
+            .prepare(`SELECT *
+         FROM dispatches
+         WHERE id = ?
+           AND workspace_id = ?
+           AND status IN ('queued', 'submitted')
+         LIMIT 1`)
+            .get(dispatchId, workspaceId);
+        return row ? toRecord(row) : undefined;
+    };
     const markReportedByWorker = (input) => {
         const dispatch = findOpenDispatch(input.workspaceId, input.toAgentId, input.dispatchId);
         if (!dispatch) {
@@ -113,6 +124,24 @@ export const createDispatchLedgerStore = (db) => {
             status: 'reported',
         };
     };
+    const markCancelled = (input) => {
+        const dispatch = findOpenDispatchById(input.workspaceId, input.dispatchId);
+        if (!dispatch) {
+            return undefined;
+        }
+        const cancelledAt = Date.now();
+        db.prepare(`UPDATE dispatches
+       SET status = ?,
+           reported_at = ?,
+           report_text = ?
+       WHERE id = ?`).run('cancelled', cancelledAt, input.reason, dispatch.id);
+        return {
+            ...dispatch,
+            reportedAt: cancelledAt,
+            reportText: input.reason,
+            status: 'cancelled',
+        };
+    };
     const listWorkspaceDispatches = (workspaceId, options = {}) => {
         const offset = options.offset ?? 0;
         const limit = options.limit ?? 100;
@@ -138,7 +167,7 @@ export const createDispatchLedgerStore = (db) => {
         return db
             .prepare(`SELECT workspace_id, to_agent_id AS worker_id, 'send' AS type
            FROM dispatches
-           WHERE status != 'reported'
+           WHERE status IN ('queued', 'submitted')
            ORDER BY sequence ASC`)
             .all();
     };
@@ -154,8 +183,10 @@ export const createDispatchLedgerStore = (db) => {
         deleteWorkerDispatches,
         deleteWorkspaceDispatches,
         findOpenDispatch,
+        findOpenDispatchById,
         listOpenDispatchKinds,
         listWorkspaceDispatches,
+        markCancelled,
         markReportedByWorker,
         markSubmitted,
     };

package/dist/src/server/hive-team-guidance.js

@@ -14,7 +14,7 @@
  * abstract identity restatement.
  */
 export const ORCHESTRATOR_REMINDER_TAIL = '<hive-system-reminder>\n' +
-    'You are the Hive Orchestrator. Reply by either: (a) `team send "<worker-name>" "<task>"` to dispatch follow-up work to a Hive worker, or (b) plain text to the user. Never call your CLI\'s built-in subagent tools (Task / Explore / etc.) — they bypass Hive and will not appear in the UI.\n' +
+    'You are the Hive Orchestrator. Reply by either: (a) `team send "<worker-name>" "<task>"` to dispatch follow-up work to a Hive worker, (b) `team cancel --dispatch <id> "<reason>"` to cancel an obsolete dispatch, or (c) plain text to the user. Never call your CLI\'s built-in subagent tools (Task / Explore / etc.) — they bypass Hive and will not appear in the UI.\n' +
     '</hive-system-reminder>';
 /**
  * Tail reminder appended to dispatches sent TO a worker. Reinforces the
@@ -31,6 +31,7 @@ const ORCHESTRATOR_RULES = [
     '普通、低风险、几分钟内能直接完成的小任务可以自己做；不要为了形式感派 worker。需要并行、长时间执行、独立 review/test、专门角色，或 user 明确要求 worker/成员处理时，再用 `team send`。',
     '如果只有一个可用 worker，直接用 `team send <worker-name> "<task>"` 派给它；不要把选择题丢回给 user。',
     '当 user 要你“让 worker ...”时，必须用 `team send <worker-name> "<task>"` 派给 Hive worker。',
+    '方向变更或 user 明确取消某个未完成派单时，使用 `team cancel --dispatch <id> "<reason>"` 显式关闭旧 dispatch；不要只用自然语言说“取消”。',
     '不要使用你所在 CLI 的内置 subagent / 子代理工具（如 Task / Explore 等）来代替 Hive worker；它们不会出现在 Hive UI，也不会更新 Hive 调度状态。',
     '`team list` 返回的 `last_pty_line` 是该 worker PTY 终端的最后一行原始输出（含任意 stdout / help / 控制序列噪声），**不是** worker 的正式汇报。正式汇报只来自 stdin 注入的 `[Hive 系统消息：来自 @<name> 的汇报]` 或 `[Hive 系统消息：来自 @<name> 的状态更新]`——只把这两种来源当作 reply。',
 ];
@@ -74,6 +75,7 @@ export const buildProtocolDoc = () => [
     '',
     '- `team list` — show workspace members and their status',
     '- `team send "<worker-name>" "<task>"` — dispatch to a worker by name (never id)',
+    '- `team cancel --dispatch <id> "<reason>"` — cancel an obsolete open dispatch',
     '',
     '## `team` CLI — worker',
     '',