@tt-a1i/hive 1.2.0 → 1.3.4

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-run-store.d.ts

@@ -27,7 +27,7 @@ export declare const createAgentRunStore: (db: Database) => {
         runId: string;
         agentId: string;
         pid: number | null;
-        status: "starting" | "running" | "exited" | "error";
+        status: "error" | "starting" | "running" | "exited";
         exitCode: number | null;
         startedAt: number;
         endedAt: number | null;

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

@@ -54,6 +54,14 @@ const CONTENT_TYPES = {
     '.webp': 'image/webp',
     '.woff2': 'font/woff2',
 };
+// PWA boot files must bypass HTTP caching: `sw.js` because the browser does its
+// own byte-diff update check, and the manifest because Chrome consults it on
+// every install/uninstall transition. Without these, SW updates can stall on a
+// stale cached copy and the install prompt won't reflect a renamed app.
+const PWA_BOOT_CACHE_CONTROL = {
+    '/manifest.webmanifest': 'max-age=0, must-revalidate',
+    '/sw.js': 'no-store',
+};
 const sendStatic = async (response, staticDir, pathname, request) => {
     if (request.method !== 'GET' && request.method !== 'HEAD')
         return false;
@@ -63,6 +71,9 @@ const sendStatic = async (response, staticDir, pathname, request) => {
     try {
         const content = await readFile(filePath);
         response.setHeader('content-type', CONTENT_TYPES[extname(filePath)] ?? 'application/octet-stream');
+        const cacheControl = PWA_BOOT_CACHE_CONTROL[pathname];
+        if (cacheControl !== undefined)
+            response.setHeader('cache-control', cacheControl);
         response.statusCode = 200;
         response.end(request.method === 'HEAD' ? undefined : content);
         return true;
@@ -118,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',
     '',

package/dist/src/server/open-target-commands.js

@@ -20,23 +20,10 @@ const macAttempts = (targetId, path) => {
             return [{ command: 'open', args: ['-a', 'Visual Studio Code - Insiders', path] }];
         case 'cursor':
             return [{ command: 'open', args: ['-a', 'Cursor', path] }];
-        case 'windsurf':
-            return [{ command: 'open', args: ['-a', 'Windsurf', path] }];
         case 'terminal':
             return [{ command: 'open', args: ['-a', 'Terminal', path] }];
-        case 'iterm2':
-            // Bundle name has always been `iTerm.app` even after the iTerm2 rename;
-            // the `iTerm2` fallback in earlier ports is cargo-cult.
-            return [{ command: 'open', args: ['-a', 'iTerm', path] }];
         case 'ghostty':
             return [{ command: 'open', args: ['-a', 'Ghostty', path] }];
-        case 'intellijidea':
-            // 2025.3 unified the editions, but installs predating that still ship
-            // `IntelliJ IDEA CE.app` — retry once on the CE bundle.
-            return [
-                { command: 'open', args: ['-a', 'IntelliJ IDEA', path] },
-                { command: 'open', args: ['-a', 'IntelliJ IDEA CE', path] },
-            ];
         case 'zed':
             return [{ command: 'open', args: ['-a', 'Zed', path] }];
     }
@@ -51,8 +38,6 @@ const linuxAttempts = (targetId, path) => {
             return [{ command: 'code-insiders', args: [path] }];
         case 'cursor':
             return [{ command: 'cursor', args: [path] }];
-        case 'windsurf':
-            return [{ command: 'windsurf', args: [path] }];
         case 'zed':
             return [{ command: 'zed', args: [path] }];
         default:
@@ -69,8 +54,6 @@ const windowsAttempts = (targetId, path) => {
             return [{ command: 'code-insiders', args: [path] }];
         case 'cursor':
             return [{ command: 'cursor', args: [path] }];
-        case 'windsurf':
-            return [{ command: 'windsurf', args: [path] }];
         case 'zed':
             return [{ command: 'zed', args: [path] }];
         default:

package/dist/src/server/package-version.d.ts

@@ -1,2 +1,17 @@
 export declare const PACKAGE_NAME = "@tt-a1i/hive";
+/**
+ * Canonical argv for the upgrade command. Sharing one source between the
+ * server's install hint (`version-service.ts`) and the CLI upgrade path
+ * (`hive-update.ts`) keeps the two from drifting if the package name ever
+ * moves.
+ */
+export declare const INSTALL_COMMAND_ARGS: readonly ["install", "-g", "@tt-a1i/hive@latest"];
+export declare const INSTALL_COMMAND_DISPLAY: string;
+/**
+ * Windows ships npm as `npm.cmd` (a batch shim); Node's `child_process.spawn`
+ * will not resolve `.cmd` without `shell: true` or an explicit suffix, so the
+ * default `'npm'` produces ENOENT on Windows. Use this helper any time you
+ * spawn npm directly.
+ */
+export declare const getNpmCommand: (platform?: NodeJS.Platform) => string;
 export declare const readPackageVersion: () => string;

package/dist/src/server/package-version.js

@@ -2,6 +2,21 @@ import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 export const PACKAGE_NAME = '@tt-a1i/hive';
+/**
+ * Canonical argv for the upgrade command. Sharing one source between the
+ * server's install hint (`version-service.ts`) and the CLI upgrade path
+ * (`hive-update.ts`) keeps the two from drifting if the package name ever
+ * moves.
+ */
+export const INSTALL_COMMAND_ARGS = ['install', '-g', `${PACKAGE_NAME}@latest`];
+export const INSTALL_COMMAND_DISPLAY = `npm ${INSTALL_COMMAND_ARGS.join(' ')}`;
+/**
+ * Windows ships npm as `npm.cmd` (a batch shim); Node's `child_process.spawn`
+ * will not resolve `.cmd` without `shell: true` or an explicit suffix, so the
+ * default `'npm'` produces ENOENT on Windows. Use this helper any time you
+ * spawn npm directly.
+ */
+export const getNpmCommand = (platform = process.platform) => platform === 'win32' ? 'npm.cmd' : 'npm';
 export const readPackageVersion = () => {
     let dir = dirname(fileURLToPath(import.meta.url));
     for (let depth = 0; depth < 8; depth += 1) {

package/dist/src/server/route-types.d.ts

@@ -22,6 +22,13 @@ export interface ReportTaskBody {
     status?: string;
     artifacts?: unknown[];
 }
+export interface CancelTaskBody {
+    dispatch_id?: string;
+    project_id: string;
+    from_agent_id: string;
+    token?: string;
+    reason?: string;
+}
 export interface CreateWorkspaceBody {
     path: string;
     name: string;

package/dist/src/server/routes-dispatches.js

@@ -1,7 +1,7 @@
 import { serializeDispatchRecord } from './dispatch-ledger-serializer.js';
 import { getRequiredParam, route, sendJson } from './route-helpers.js';
 import { requireUiTokenFromRequest } from './ui-auth-helpers.js';
-const DISPATCH_STATUSES = new Set(['queued', 'submitted', 'reported']);
+const DISPATCH_STATUSES = new Set(['queued', 'submitted', 'reported', 'cancelled']);
 const MAX_DISPATCH_LIMIT = 100;
 const MAX_DISPATCH_OFFSET = 100_000;
 const readBoundedInt = (response, value, name, fallback, max) => {
@@ -33,7 +33,9 @@ export const dispatchRoutes = [
         }
         const state = url.searchParams.get('state');
         if (state !== null && !isDispatchStatus(state)) {
-            sendJson(response, 400, { error: 'state must be queued, submitted, or reported' });
+            sendJson(response, 400, {
+                error: 'state must be queued, submitted, reported, or cancelled',
+            });
             return;
         }
         const limit = readBoundedInt(response, url.searchParams.get('limit'), 'limit', MAX_DISPATCH_LIMIT, MAX_DISPATCH_LIMIT);

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

@@ -25,6 +25,7 @@ export const runtimeRoutes = [
             agent_name: summary?.agent_name ?? 'Shell',
             run_id: run.runId,
             status: run.status,
+            terminal_input_profile: summary?.terminal_input_profile ?? 'default',
         });
     }),
     route('DELETE', '/api/workspaces/:workspaceId/shell/:runId', ({ params, request, response, store }) => {

package/dist/src/server/routes-team.js

@@ -29,6 +29,28 @@ export const teamRoutes = [
         });
         sendJson(response, 202, { dispatch_id: dispatch.id, ok: true });
     }),
+    route('POST', '/api/team/cancel', async ({ request, response, store }) => {
+        const body = await readJsonBody(request);
+        const projectId = requireNonEmptyString(body.project_id, 'project_id');
+        const fromAgentId = requireNonEmptyString(body.from_agent_id, 'from_agent_id');
+        const dispatchId = requireNonEmptyString(body.dispatch_id, 'dispatch_id');
+        const reason = requireNonEmptyString(body.reason, 'reason');
+        const agent = authenticateCliAgent({
+            fromAgentId,
+            getAgent: store.getAgent,
+            token: body.token,
+            validateToken: store.validateAgentToken,
+            workspaceId: projectId,
+        });
+        requireCommandForRole(agent, 'cancel');
+        const result = store.cancelTask(projectId, dispatchId, { fromAgentId, reason });
+        sendJson(response, 202, {
+            dispatch_id: result.dispatch?.id ?? null,
+            forward_error: result.forwardError,
+            forwarded: result.forwarded,
+            ok: true,
+        });
+    }),
     route('POST', '/api/team/report', async ({ request, response, store }) => {
         const body = await readJsonBody(request);
         const projectId = requireNonEmptyString(body.project_id, 'project_id');

package/dist/src/server/runtime-store-helpers.d.ts

@@ -52,6 +52,7 @@ export declare const createRuntimeStoreLifecycle: ({ agentManager, services, }:
         agent_name: string;
         run_id: string;
         status: import("./agent-manager.js").RunStatus;
+        terminal_input_profile: import("./terminal-input-profile.js").TerminalInputProfile;
     }[];
     startAgent: (workspaceId: string, agentId: string, input: {
         hivePort: string;
@@ -74,7 +75,7 @@ export declare const createRuntimeStoreLifecycle: ({ agentManager, services, }:
     })[]>;
     registerTasksListener: (listener: (workspaceId: string, content: string) => void) => () => void;
     startWorkspaceWatch: (workspaceId: string) => Promise<void>;
-    writeRunInput: (runId: string, text: string) => void;
+    writeRunInput: (runId: string, input: Buffer | string) => void;
     pauseTerminalRun: (runId: string) => void;
     resizeTerminalRun: (runId: string, cols: number, rows: number) => void;
     resumeTerminalRun: (runId: string) => void;

package/dist/src/server/runtime-store-helpers.js

@@ -10,6 +10,7 @@ import { createSettingsStore } from './settings-store.js';
 import { createTasksFileService } from './tasks-file.js';
 import { createTasksFileWatcher } from './tasks-file-watcher.js';
 import { createTeamOperations } from './team-operations.js';
+import { resolveTerminalInputProfile } from './terminal-input-profile.js';
 import { createUiAuth } from './ui-auth.js';
 import { createWorkerOutputTracker } from './worker-output-tracker.js';
 import { createWorkspaceShellRuntime } from './workspace-shell-runtime.js';
@@ -63,7 +64,9 @@ export const createRuntimeStoreServices = (options = {}) => {
         deleteDispatch: dispatchLedgerStore.deleteDispatch,
         deleteMessage: messageLogStore.deleteMessage,
         findOpenDispatch: dispatchLedgerStore.findOpenDispatch,
+        findOpenDispatchById: dispatchLedgerStore.findOpenDispatchById,
         insertMessage: messageLogStore.insertMessage,
+        markDispatchCancelled: dispatchLedgerStore.markCancelled,
         markDispatchReportedByWorker: dispatchLedgerStore.markReportedByWorker,
         markDispatchSubmitted: dispatchLedgerStore.markSubmitted,
         workspaceStore,
@@ -167,8 +170,15 @@ export const createRuntimeStoreLifecycle = ({ agentManager, services, }) => {
                 const run = services.agentRuntime.getActiveRunByAgentId(workspaceId, agent.id);
                 if (!run)
                     return [];
+                const launchConfig = services.agentRuntime.peekAgentLaunchConfig(workspaceId, agent.id);
                 return [
-                    { agent_id: agent.id, agent_name: agent.name, run_id: run.runId, status: run.status },
+                    {
+                        agent_id: agent.id,
+                        agent_name: agent.name,
+                        run_id: run.runId,
+                        status: run.status,
+                        terminal_input_profile: resolveTerminalInputProfile(launchConfig),
+                    },
                 ];
             }),
             ...services.shellRuntime.listTerminalRuns(workspaceId),
@@ -186,14 +196,14 @@ export const createRuntimeStoreLifecycle = ({ agentManager, services, }) => {
             const workspace = services.workspaceStore.getWorkspaceSnapshot(workspaceId);
             await services.tasksFileWatcher.start(workspaceId, workspace.summary.path);
         },
-        writeRunInput: (runId, text) => {
+        writeRunInput: (runId, input) => {
             if (!agentManager)
                 throw new Error('Agent manager is required for PTY stdin writes');
             if (services.shellRuntime.hasRun(runId)) {
-                services.shellRuntime.writeInput(runId, text);
+                services.shellRuntime.writeInput(runId, input);
                 return;
             }
-            agentManager.writeInput(runId, text);
+            agentManager.writeInput(runId, input);
         },
         pauseTerminalRun: (runId) => {
             if (services.shellRuntime.hasRun(runId))

package/dist/src/server/runtime-store.d.ts

@@ -6,7 +6,8 @@ import type { DispatchRecord, ListDispatchesOptions } from './dispatch-ledger-st
 import type { RecoveryMessage } from './message-log-store.js';
 import type { PtyOutputBus } from './pty-output-bus.js';
 import type { SettingsStore } from './settings-store.js';
-import type { DispatchTaskInput, ReportTaskInput, ReportTaskResult, StatusTaskInput } from './team-operations.js';
+import type { CancelTaskInput, DispatchTaskInput, ReportTaskInput, ReportTaskResult, StatusTaskInput } from './team-operations.js';
+import type { TerminalRunSummary } from './terminal-input-profile.js';
 import type { WorkerInput, WorkspaceRecord } from './workspace-store.js';
 interface RuntimeStore {
     close: () => Promise<void>;
@@ -21,6 +22,7 @@ interface RuntimeStore {
     dispatchTaskByWorkerName: (workspaceId: string, workerName: string, text: string, input?: DispatchTaskInput) => Promise<DispatchRecord>;
     reportTask: (workspaceId: string, workerId: string, input?: ReportTaskInput) => ReportTaskResult;
     statusTask: (workspaceId: string, workerId: string, input?: StatusTaskInput) => ReportTaskResult;
+    cancelTask: (workspaceId: string, dispatchId: string, input: CancelTaskInput) => ReportTaskResult;
     listDispatches: (workspaceId: string, options?: ListDispatchesOptions) => DispatchRecord[];
     listWorkers: (workspaceId: string) => TeamListItem[];
     getLastPtyLineForAgent: (workspaceId: string, agentId: string) => string | null;
@@ -28,12 +30,7 @@ interface RuntimeStore {
     getWorker: (workspaceId: string, workerId: string) => AgentSummary;
     getAgent: (workspaceId: string, agentId: string) => AgentSummary;
     getPtyOutputBus: () => PtyOutputBus;
-    listTerminalRuns: (workspaceId: string) => Array<{
-        agent_id: string;
-        agent_name: string;
-        run_id: string;
-        status: string;
-    }>;
+    listTerminalRuns: (workspaceId: string) => TerminalRunSummary[];
     closeWorkspaceShell: (workspaceId: string, runId: string) => boolean;
     startWorkspaceShell: (workspaceId: string) => Promise<LiveAgentRun>;
     configureAgentLaunch: (workspaceId: string, agentId: string, input: AgentLaunchConfigInput) => void;
@@ -57,7 +54,7 @@ interface RuntimeStore {
     resizeAgentRun: (runId: string, cols: number, rows: number) => void;
     resumeTerminalRun: (runId: string) => void;
     settings: SettingsStore;
-    writeRunInput: (runId: string, text: string) => void;
+    writeRunInput: (runId: string, input: Buffer | string) => void;
     getUiToken: () => string;
     stopAgentRun: (runId: string) => void;
     validateAgentToken: (agentId: string, token: string | undefined) => boolean;

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

@@ -48,6 +48,7 @@ export const createRuntimeStore = (options = {}) => {
             });
         },
         recordUserInput: services.teamOps.recordUserInput,
+        cancelTask: services.teamOps.cancelTask,
         dispatchTask: services.teamOps.dispatchTask,
         dispatchTaskByWorkerName: services.teamOps.dispatchTaskByWorkerName,
         reportTask: services.teamOps.reportTask,