@kw-yeh/vibeflow 4.11.33 → 4.11.36

package/dist/vibeflow.mjs

@@ -494,6 +494,9 @@ var init_tmux_backend = __esm({
       write(key, data) {
         this.clients.get(key)?.proc.write(data);
       }
+      isAttached(key) {
+        return this.clients.has(key);
+      }
       resize(key, cols, rows) {
         try {
           this.clients.get(key)?.proc.resize(Math.max(cols, 1), Math.max(rows, 1));
@@ -543,6 +546,7 @@ function boardEnvPrefix(task, opts, workspacePath) {
   if (!board) return "";
   const entries = [
     ["VIBEFLOW_TASK_ID", task.id],
+    ["VIBEFLOW_MASTER_ID", task.masterId],
     ["VIBEFLOW_PROJECT_PATH", task.projectPath],
     ["VIBEFLOW_BRANCH", task.branch],
     ["VIBEFLOW_BASE_BRANCH", task.baseBranch],
@@ -594,6 +598,26 @@ function buildClaudeSettings(worktreePath) {
 function resolveSystemPrompt(custom) {
   return custom && custom.trim() ? custom : "";
 }
+function slaveSystemPrompt(opts) {
+  const lines = [
+    "\u9019\u5F35\u5361\u7247\u7531 VibeFlow \u7684 Master agent \u6D3E\u5DE5\u4E26\u7D71\u7C4C\uFF08master \u7684 id \u5728 $VIBEFLOW_MASTER_ID\uFF09\uFF1B\u4F7F\u7528\u8005\u4E3B\u8981\u900F\u904E master \u8DDF\u4F60\u5354\u4F5C\u3002",
+    '\u4F60\u6536\u5230\u7684 <vibeflow from="\u2026"> \u8A0A\u606F\u4F86\u81EA master \u6216 VibeFlow \u672C\u8EAB\uFF0C\u7167\u5176\u4E2D\u7684\u6307\u793A\u505A\u3002'
+  ];
+  if (!opts.canWrite) {
+    lines.push("\u9019\u6B21\u555F\u52D5\u7121\u6CD5\u4F7F\u7528 board CLI\uFF0C\u4F60\u4E0D\u80FD\u4E3B\u52D5\u56DE\u5831\uFF1B\u5B8C\u6210\u6216\u5361\u4F4F\u6642\u76F4\u63A5\u5728 terminal \u5BEB\u6E05\u695A\u7D50\u679C\u3002");
+    return lines.join("\n");
+  }
+  lines.push(
+    "",
+    ...BOARD_CLI_SETUP,
+    "",
+    "\u56DE\u5831\uFF1A\u4EFB\u52D9\u5B8C\u6210\u3001\u9700\u8981 master \u6C7A\u5B9A\u3001\u6216\u5361\u4F4F\u7121\u6CD5\u7E7C\u7E8C\u6642\uFF0C\u7ACB\u523B\u7528\u9019\u500B\u6307\u4EE4\u56DE\u5831\uFF0C\u7136\u5F8C\u505C\u4E0B\u4F86\u7B49\u4E0B\u4E00\u6B65\u6307\u793A\uFF1A",
+    '  VF task send --store-path "$VIBEFLOW_STORE_DIR" --task "$VIBEFLOW_MASTER_ID" --text "<\u56DE\u5831\u5167\u5BB9>"',
+    "\u56DE\u5831\u5167\u5BB9\u8981\u81EA\u5305\u542B\uFF1A\u505A\u4E86\u4EC0\u9EBC\u3001\u600E\u9EBC\u9A57\u8B49\u3001\u7D50\u679C\uFF1B\u9A57\u6536\u985E\u5DE5\u4F5C\u9010\u9805\u5217\u51FA\u901A\u904E\u8207\u672A\u901A\u904E\u7684\u9805\u76EE\u53CA\u91CD\u73FE\u6B65\u9A5F\uFF1B\u958B\u4E86 PR \u5C31\u9644\u4E0A\u9023\u7D50\u3002",
+    "\u6C92\u6709 master \u8981\u6C42\u5C31\u4E0D\u8981\u958B PR\u3002"
+  );
+  return lines.join("\n");
+}
 function masterSystemPrompt(opts) {
   const lines = [
     "\u4F60\u662F VibeFlow \u7684 Master agent\uFF0C\u4E0D\u5C6C\u65BC\u4EFB\u4F55 repo\uFF0C\u5DE5\u4F5C\u76EE\u9304\u53EA\u662F\u4F60\u7684\u7B46\u8A18\u5340\u3002",
@@ -608,8 +632,7 @@ function masterSystemPrompt(opts) {
     return lines.join("\n");
   }
   lines.push(
-    '\u5148\u5B9A\u7FA9\u9019\u500B shell \u51FD\u5F0F\uFF0C\u4E4B\u5F8C\u6240\u6709\u6307\u4EE4\u90FD\u7528\u5B83\uFF0C\u4E26\u4E14\u4E00\u5F8B\u5E36\u4E0A --store-path "$VIBEFLOW_STORE_DIR"\uFF1A',
-    '  VF() { if [ -n "$VIBEFLOW_CLI_LOADER" ]; then node --experimental-strip-types --import "$VIBEFLOW_CLI_LOADER" "$VIBEFLOW_CLI" "$@"; else node "$VIBEFLOW_CLI" "$@"; fi; }',
+    ...BOARD_CLI_SETUP,
     "",
     "1. \u5224\u65B7\uFF1A\u4E00\u5F35\u5361\u505A\u5F97\u5B8C\u5C31\u53EA\u5EFA\u4E00\u5F35\uFF1B\u6D89\u53CA\u591A\u500B repo \u6216\u53EF\u5E73\u884C\u7684\u7368\u7ACB\u5DE5\u4F5C\u624D\u62C6\u6210\u591A\u5F35\u3002\u6BCF\u5F35\u53EA\u52D5\u4E00\u500B repo\uFF0C\u5404\u81EA\u80FD\u7368\u7ACB\u9A57\u6536\u3002",
     '2. \u6D3E\u5DE5\uFF1AVF task create --store-path "$VIBEFLOW_STORE_DIR" --master "$VIBEFLOW_TASK_ID" --project <repo \u7D55\u5C0D\u8DEF\u5F91> --title <\u6A19\u984C> --prompt <\u5167\u5BB9>',
@@ -620,9 +643,13 @@ function masterSystemPrompt(opts) {
     opts.autoMode ? '3. \u555F\u52D5\uFF1A\u6C92\u6709\u524D\u7F6E\u4F9D\u8CF4\u7684\u5361\u76F4\u63A5 VF task start --store-path "$VIBEFLOW_STORE_DIR" --task <id>\uFF1B\u6709\u4F9D\u8CF4\u7684\u5148\u7559\u5728 Backlog\uFF0C\u524D\u7F6E\u5361\u5B8C\u6210\u5F8C\u518D\u555F\u52D5\u3002' : "3. \u555F\u52D5\uFF1A\u4E0D\u8981\u81EA\u5DF1\u555F\u52D5\u5361\u7247\u3002\u5217\u51FA\u4F60\u5EFA\u4E86\u54EA\u4E9B\u5361\u3001\u5EFA\u8B70\u7684\u555F\u52D5\u9806\u5E8F\uFF0C\u7B49\u4F7F\u7528\u8005\u5728 VibeFlow \u6309\u958B\u59CB\u3002"
   );
   lines.push(
-    '4. \u76E3\u807D\uFF1AVF task list --store-path "$VIBEFLOW_STORE_DIR" --master "$VIBEFLOW_TASK_ID" \u6703\u56DE\u50B3\u6BCF\u5F35\u5361\u7684\u6B04\u4F4D\u3001\u662F\u5426\u5728\u8DD1\u3001todo \u9032\u5EA6\u3001\u6D3B\u52D5\u72C0\u614B\u8207 PR\u3002',
-    "   \u5B9A\u671F\u67E5\u770B\uFF1B\u5361\u5728\u7B49\u5F85\u6B0A\u9650\u3001\u6709 launchError\u3001\u6216\u9577\u6642\u9593\u6C92\u6709\u6D3B\u52D5\u6642\uFF0C\u544A\u8A34\u4F7F\u7528\u8005\u4E26\u63D0\u51FA\u8655\u7406\u65B9\u5F0F\u3002",
-    "5. \u4F60\u4E0D\u6703\u628A\u5361\u7247\u79FB\u5230 Done\u3001\u4E0D\u6703\u5408\u4F75 PR\u3002\u5168\u90E8 slave \u5B8C\u6210\u5F8C\uFF0C\u6574\u7406\u6BCF\u5F35\u7684\u7D50\u679C\u8207 PR \u9023\u7D50\uFF0C\u4EA4\u7D66\u4F7F\u7528\u8005\u505A\u6700\u5F8C\u78BA\u8A8D\u3002"
+    "4. \u56DE\u5831\u6703\u81EA\u5DF1\u9001\u4F86\uFF1Aslave \u505A\u5B8C\u3001\u8981\u4F60\u6C7A\u5B9A\u6216\u5361\u4F4F\u6642\u6703\u7528 task send \u56DE\u5831\uFF1Bslave \u5361\u5728\u6B0A\u9650\u78BA\u8A8D\u3001\u555F\u52D5\u5931\u6557\u3001session \u7D50\u675F\u3001\u6216\u56DE\u5408\u7D50\u675F\u537B\u6C92\u56DE\u5831\u6642\uFF0CVibeFlow \u4E5F\u6703\u901A\u77E5\u4F60\u3002",
+    '   \u9019\u4E9B\u8A0A\u606F\u4EE5 <vibeflow from="\u2026"> \u5305\u4F4F\u3001\u76F4\u63A5\u51FA\u73FE\u5728\u4F60\u7684\u8F38\u5165\u88E1\u3002\u4E0D\u8981\u8F2A\u8A62 task list\uFF1B\u8981\u770B\u7D30\u7BC0\u6642\u624D\u7528 VF task show --store-path "$VIBEFLOW_STORE_DIR" --task <id>\u3002',
+    '5. \u8ABF\u5EA6\uFF1A\u7528 VF task send --store-path "$VIBEFLOW_STORE_DIR" --task <id> --text <\u5167\u5BB9> \u5C0D\u81EA\u5DF1\u7684\u5361\u4E0B\u6307\u793A\uFF1B\u5361\u8207\u5361\u4E4B\u9593\u4E0D\u80FD\u76F4\u63A5\u50B3\u8A71\uFF0C\u4E00\u5F8B\u7D93\u904E\u4F60\u3002',
+    "   \u9700\u8981\u7368\u7ACB\u9A57\u6536\u6642\u53E6\u958B\u4E00\u5F35\u9A57\u6536\u5361\u3002\u9A57\u6536\u56DE\u5831\u554F\u984C\u6642\uFF0C\u628A\u5177\u9AD4\u554F\u984C\u8207\u91CD\u73FE\u6B65\u9A5F\u6574\u7406\u597D\u8F49\u7D66\u8CA0\u8CAC\u958B\u767C\u7684\u5361\u4FEE\u6B63\uFF0C\u4FEE\u5B8C\u518D\u8ACB\u9A57\u6536\u5361\u8907\u9A57\uFF0C\u76F4\u5230\u901A\u904E\u3002",
+    "   task send \u56DE TARGET_BLOCKED \u4EE3\u8868\u5C0D\u65B9\u5361\u5728\u6B0A\u9650\u78BA\u8A8D\uFF0C\u8ACB\u4F7F\u7528\u8005\u5230\u90A3\u5F35\u5361\u8655\u7406\u3002",
+    "6. PR\uFF1A\u9A57\u6536\u901A\u904E\u5F8C\uFF0C\u4EA4\u4EE3\u958B\u767C\u5361\u7528 pr skill \u958B PR\uFF08\u74B0\u5883\u88E1\u6C92\u6709\u9019\u500B skill \u5C31\u7528 gh pr create\uFF09\uFF0C\u4E26\u56DE\u5831 PR \u9023\u7D50\u7D66\u4F60\u3002",
+    "7. \u4F7F\u7528\u8005\u4E3B\u8981\u53EA\u8DDF\u4F60\u6E9D\u901A\uFF1A\u4E3B\u52D5\u5411\u4F7F\u7528\u8005\u56DE\u5831\u6574\u9AD4\u9032\u5EA6\u8207\u9700\u8981\u4F7F\u7528\u8005\u6C7A\u5B9A\u7684\u4E8B\u3002\u4F60\u4E0D\u6703\u628A\u5361\u7247\u79FB\u5230 Done\u3001\u4E0D\u6703\u5408\u4F75 PR\uFF1B\u5168\u90E8\u5B8C\u6210\u5F8C\u6574\u7406\u6BCF\u5F35\u5361\u7684\u7D50\u679C\u8207 PR \u9023\u7D50\uFF0C\u4EA4\u7D66\u4F7F\u7528\u8005\u505A\u6700\u5F8C\u78BA\u8A8D\u3002"
   );
   return lines.join("\n");
 }
@@ -687,7 +714,9 @@ function buildAgentCommand(task, systemPrompt, opts, workspacePath) {
   const agent = taskAgent(task);
   const model = taskModel(task);
   const custom = resolveSystemPrompt(systemPrompt);
-  const sys = task.role === "master" ? [custom, masterSystemPrompt({ canWrite: Boolean(opts?.boardCli?.cliPath), autoMode: opts?.autoMode === true })].filter(Boolean).join("\n\n") : custom;
+  const canWrite = Boolean(opts?.boardCli?.cliPath);
+  const role = task.role === "master" ? masterSystemPrompt({ canWrite, autoMode: opts?.autoMode === true }) : task.masterId ? slaveSystemPrompt({ canWrite }) : null;
+  const sys = role ? [custom, role].filter(Boolean).join("\n\n") : custom;
   const includeTaskPrompt = opts?.includeTaskPrompt !== false;
   const prompt = includeTaskPrompt && !opts?.resume ? buildPrompt(task) : "";
   const sessionId = agent === "claude" && includeTaskPrompt ? executorSessionId(task.id, task.runId) : void 0;
@@ -703,7 +732,7 @@ function buildAgentCommand(task, systemPrompt, opts, workspacePath) {
     workspacePath
   );
 }
-var ARTIFACTS_DIR_SUFFIX, SCRATCH_DIR_NAME, ARTIFACTS_FALLBACK_DIR, AUTO_PERMISSION_MODE, SUBAGENTS_DIR2, PROGRESS_EVENTS_DIR, TODO_TOOLS, AGENT_NAMES, RETIRED_MODELS;
+var ARTIFACTS_DIR_SUFFIX, SCRATCH_DIR_NAME, ARTIFACTS_FALLBACK_DIR, AUTO_PERMISSION_MODE, SUBAGENTS_DIR2, PROGRESS_EVENTS_DIR, TODO_TOOLS, BOARD_CLI_SETUP, AGENT_NAMES, RETIRED_MODELS;
 var init_launch = __esm({
   "packages/core/src/launch.ts"() {
     "use strict";
@@ -714,6 +743,10 @@ var init_launch = __esm({
     SUBAGENTS_DIR2 = ".vibeflow-subagents";
     PROGRESS_EVENTS_DIR = ".vibeflow-events";
     TODO_TOOLS = "TodoWrite|TaskCreate|TaskUpdate";
+    BOARD_CLI_SETUP = [
+      '\u5148\u5B9A\u7FA9\u9019\u500B shell \u51FD\u5F0F\uFF0C\u4E4B\u5F8C\u6240\u6709\u6307\u4EE4\u90FD\u7528\u5B83\uFF0C\u4E26\u4E14\u4E00\u5F8B\u5E36\u4E0A --store-path "$VIBEFLOW_STORE_DIR"\uFF1A',
+      '  VF() { if [ -n "$VIBEFLOW_CLI_LOADER" ]; then node --experimental-strip-types --import "$VIBEFLOW_CLI_LOADER" "$VIBEFLOW_CLI" "$@"; else node "$VIBEFLOW_CLI" "$@"; fi; }'
+    ];
     AGENT_NAMES = {
       claude: "Claude Code",
       codex: "Codex CLI"
@@ -2579,6 +2612,8 @@ function createBridge(t) {
     startTask: (taskId) => t.invoke("vibeflow:startTask", taskId),
     /** Cards as a master sees them; filter by master or a single card. */
     taskSummaries: (filter) => t.invoke("task:summaries", filter),
+    /** Type a message into another card's agent: a master to its cards, a card to its master. */
+    sendMessage: (payload) => t.invoke("vibeflow:sendMessage", payload),
     /** Clear prior execution state and prepare a fresh run of this task. */
     resetTaskRun: (taskId) => t.invoke("vibeflow:resetTaskRun", taskId),
     removeTask: (taskId) => t.invoke("vibeflow:removeTask", taskId),
@@ -4748,7 +4783,7 @@ function connectToHost(lock) {
 // packages/cli/src/task-command.ts
 var AGENT_IDS = AGENT_CLIS.map((agent) => agent.id);
 var STATUSES = ["backlog", "in_progress", "done"];
-var SUBCOMMANDS = ["create", "update", "start", "list", "show", "artifact"];
+var SUBCOMMANDS = ["create", "update", "start", "list", "show", "send", "artifact"];
 var ROLES = ["slave", "master"];
 var MODES = ["existing", "new"];
 var AUTO_MODES = ["on", "off"];
@@ -4761,6 +4796,7 @@ Usage:
   vibeflow task start --task <id> [options]
   vibeflow task list [--master <id>] [options]
   vibeflow task show --task <id> [options]
+  vibeflow task send --task <id> --text <text> [options]
   vibeflow task artifact add --file <path> [options]
 
 task create options:
@@ -4769,7 +4805,8 @@ task create options:
   --project <path>       Target project directory (required for a slave)
   --work-dir <path>      Master only: run in this existing folder (git or not)
                          instead of one VibeFlow creates
-  --master <id>          Dispatch the new card under this master card
+  --master <id>          Dispatch the new card under this master card (default: the
+                         calling card, when a master runs this from its own shell)
   --title <text>         Task title (required)
   --prompt <text>        Task prompt / description (required)
   --status <column>      ${STATUSES.join(" | ")}  (default: backlog)
@@ -4800,12 +4837,17 @@ task update options:
   At least one of --title / --prompt / --status / --master is required. Branch,
   worktree and project path are provisioned on disk and cannot be changed here.
 
-task start / list / show (need the running VibeFlow host):
+task start / list / show / send (need the running VibeFlow host):
   start --task <id>      Move a Backlog card to In Progress and start its agent,
                          the same as dragging it in the app
   list [--master <id>]   Every card, or one master's cards, with column, whether
                          its agent is running, todo progress, activity and PR
   show --task <id>       The same summary for one card
+  send --task <id> --text <text> [--force] [--from <id>]
+                         Type a message into that card's agent, tagged with the
+                         sender. Only a master and its own cards can message each
+                         other. --from defaults to VIBEFLOW_TASK_ID; --force types
+                         even into a permission dialog
 
 task artifact add options:
   --file <path>         Copy a file into the card's user-facing Artifacts folder
@@ -4884,6 +4926,9 @@ async function taskCommand(argv) {
         "auto-mode": { type: "string" },
         attach: { type: "string", multiple: true },
         file: { type: "string" },
+        text: { type: "string" },
+        from: { type: "string" },
+        force: { type: "boolean" },
         "store-path": { type: "string" },
         profile: { type: "string" },
         help: { type: "boolean", short: "h" }
@@ -4962,11 +5007,13 @@ async function taskCommand(argv) {
   } catch (err) {
     fail("ATTACHMENT_READ_FAILED", `\u7121\u6CD5\u8B80\u53D6\u9644\u4EF6\uFF1A${err.message}`);
   }
+  const caller = process.env.VIBEFLOW_TASK_ID ? findTask(process.env.VIBEFLOW_TASK_ID) : void 0;
+  const masterId = values.master ?? (!master && caller && isMasterTask(caller) ? caller.id : void 0);
   const { task, storePath: resolvedPath } = await createTaskFromInput({
     projectPath: values.project,
     role: master ? "master" : void 0,
     workDir: values["work-dir"],
-    masterId: values.master,
+    masterId,
     title: values.title,
     description: values.prompt,
     status: values.status ?? "backlog",
@@ -4998,9 +5045,13 @@ async function taskCommand(argv) {
     }
   };
 }
-var HOST_COMMANDS = ["start", "list", "show"];
+var HOST_COMMANDS = ["start", "list", "show", "send"];
 async function hostCommand(sub, values, storePath) {
   if (sub !== "list" && !values.task) fail("MISSING_ARGUMENT", "Missing required arguments: --task");
+  const from = values.from ?? process.env.VIBEFLOW_TASK_ID;
+  if (sub === "send" && (!values.text || !from)) {
+    fail("MISSING_ARGUMENT", "task send needs --text and --from (or VIBEFLOW_TASK_ID)");
+  }
   const lock = liveHost(storePath);
   if (!lock) fail("HOST_NOT_RUNNING", `No VibeFlow host is running for ${storePath}. Start it with \`vibeflow\` first.`);
   const remote = connectToHost(lock);
@@ -5009,12 +5060,21 @@ async function hostCommand(sub, values, storePath) {
       const { task } = await remote.api.startTask(values.task);
       return { task: { id: task.id, title: task.title, worktreePath: task.worktreePath ?? null } };
     }
+    if (sub === "send") {
+      try {
+        return await remote.api.sendMessage({ from, to: values.task, text: values.text, force: values.force === true });
+      } catch (err) {
+        const e = err;
+        fail(e.code ?? "HOST_ERROR", e.message ?? String(err));
+      }
+    }
     if (sub === "show") {
       const [task] = await remote.api.taskSummaries({ taskId: values.task });
       return { task };
     }
     return { tasks: await remote.api.taskSummaries(values.master ? { masterId: values.master } : void 0) };
   } catch (err) {
+    if (err instanceof CliFailure) throw err;
     fail("HOST_ERROR", err.message);
   } finally {
     remote.close();
@@ -7199,11 +7259,201 @@ function createProgressTracker(opts) {
   };
 }
 
+// packages/core/src/mailbox.ts
+var PASTE_START = "\x1B[200~";
+var PASTE_END = "\x1B[201~";
+var PASTE_GAP_MS = 200;
+var DEFAULT_QUIET_MS = 3e3;
+var DEFAULT_TIMEOUT_MS = 12e4;
+function coded(code2, message) {
+  return Object.assign(new Error(message), { code: code2 });
+}
+function isBlocked(activity) {
+  return activity?.state === "waiting" && activity.waitingFor === "permission";
+}
+function bracketedPaste(text) {
+  return PASTE_START + text.split(PASTE_END).join("") + PASTE_END;
+}
+function frameMessage(from, text) {
+  const sender = from ? `${from.id} ${from.title}`.replace(/["\r\n]/g, " ") : "vibeflow";
+  const body = text.replace(/<(\/?)vibeflow/gi, "\u2039$1vibeflow");
+  return `<vibeflow from="${sender}">
+${body}
+</vibeflow>`;
+}
+function quietFromEnv() {
+  const n = Number(process.env.VIBEFLOW_QUIET_MS);
+  return Number.isFinite(n) && n >= 0 ? n : DEFAULT_QUIET_MS;
+}
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function createMailbox(options) {
+  const lastInput = /* @__PURE__ */ new Map();
+  const held = /* @__PURE__ */ new Map();
+  const turns = /* @__PURE__ */ new Map();
+  async function waitForQuiet(key, started) {
+    const quiet = options.quietMs ?? quietFromEnv();
+    const timeout = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    for (; ; ) {
+      const left = (lastInput.get(key) ?? 0) + quiet - Date.now();
+      if (left <= 0) return;
+      if (Date.now() - started > timeout) throw coded("TIMEOUT", "the terminal never went quiet");
+      await sleep(Math.min(left, 250));
+    }
+  }
+  async function type(key, text, opts, started) {
+    await waitForQuiet(key, started);
+    if (!opts.force && isBlocked(options.activity(key))) {
+      throw coded("TARGET_BLOCKED", "the agent is on a permission dialog; typing could answer it");
+    }
+    held.set(key, []);
+    try {
+      options.write(key, bracketedPaste(text));
+      await sleep(PASTE_GAP_MS);
+      options.write(key, "\r");
+    } finally {
+      const keys = held.get(key) ?? [];
+      held.delete(key);
+      if (keys.length) {
+        options.write(key, keys.join(""));
+        lastInput.set(key, Date.now());
+      }
+    }
+    return { queuedMs: Date.now() - started };
+  }
+  return {
+    userInput(key, data) {
+      const buffer = held.get(key);
+      if (buffer) {
+        buffer.push(data);
+        return;
+      }
+      lastInput.set(key, Date.now());
+      options.write(key, data);
+    },
+    deliver(key, text, opts = {}) {
+      const started = Date.now();
+      const run3 = (turns.get(key) ?? Promise.resolve()).catch(() => {
+      }).then(() => type(key, text, opts, started));
+      turns.set(key, run3);
+      void run3.finally(() => {
+        if (turns.get(key) === run3) turns.delete(key);
+      }).catch(() => {
+      });
+      return run3;
+    },
+    forget(key) {
+      lastInput.delete(key);
+      held.delete(key);
+    }
+  };
+}
+
+// packages/core/src/notifier.ts
+function describe(kind, id, title, detail) {
+  const card = `\u5361\u7247 ${id}\u300C${title}\u300D`;
+  const look = `\u67E5\u770B\uFF1AVF task show --store-path "$VIBEFLOW_STORE_DIR" --task ${id}`;
+  switch (kind) {
+    case "blocked":
+      return `${card} \u5361\u5728\u6B0A\u9650\u78BA\u8A8D\uFF0C\u7B49\u4F7F\u7528\u8005\u5141\u8A31\u624D\u6703\u7E7C\u7E8C\u3002${look}`;
+    case "launch_failed":
+      return `${card} \u555F\u52D5\u5931\u6557\uFF0C\u5DF2\u9000\u56DE Backlog\uFF1A${detail ?? "\u539F\u56E0\u4E0D\u660E"}\u3002${look}`;
+    case "exited":
+      return `${card} \u7684 agent session \u5DF2\u7D50\u675F\u3002${look}`;
+    case "turn_unreported":
+      return `${card} \u9019\u4E00\u56DE\u5408\u7D50\u675F\u4E86\uFF0C\u4F46\u6C92\u6709\u56DE\u5831\u7D50\u679C\uFF08\u53EF\u80FD\u5728\u7B49\u4EBA\u56DE\u7B54\u554F\u984C\uFF09\u3002${look}`;
+  }
+}
+function createNotifier(options) {
+  const states = /* @__PURE__ */ new Map();
+  const inTurn = /* @__PURE__ */ new Set();
+  const reportedThisTurn = /* @__PURE__ */ new Set();
+  const told = /* @__PURE__ */ new Map();
+  const pending = /* @__PURE__ */ new Map();
+  const flushing = /* @__PURE__ */ new Set();
+  function note(taskId, kind, detail) {
+    const card = options.cardOf(taskId);
+    if (!card) return;
+    const seen = told.get(taskId) ?? /* @__PURE__ */ new Set();
+    if (seen.has(kind)) return;
+    seen.add(kind);
+    told.set(taskId, seen);
+    const queue = pending.get(card.masterId) ?? [];
+    queue.push(describe(kind, taskId, card.title, detail));
+    pending.set(card.masterId, queue);
+    schedule(card.masterId);
+  }
+  function schedule(masterId) {
+    setTimeout(() => void flush(masterId), 0);
+  }
+  async function flush(masterId) {
+    if (flushing.has(masterId) || !pending.get(masterId)?.length) return;
+    flushing.add(masterId);
+    try {
+      const can = await options.canReceive(masterId);
+      if (can === "never") {
+        pending.delete(masterId);
+        return;
+      }
+      if (can === "later") return;
+      const batch = pending.get(masterId) ?? [];
+      pending.delete(masterId);
+      try {
+        await options.deliver(masterId, batch.join("\n"));
+      } catch {
+        pending.set(masterId, [...batch, ...pending.get(masterId) ?? []]);
+      }
+    } finally {
+      flushing.delete(masterId);
+    }
+    if (pending.get(masterId)?.length) schedule(masterId);
+  }
+  function turnStarted(taskId) {
+    inTurn.add(taskId);
+    reportedThisTurn.delete(taskId);
+    told.delete(taskId);
+  }
+  return {
+    activity(taskId, activity) {
+      const before = states.get(taskId);
+      states.set(taskId, activity);
+      const wasBlocked = before?.state === "waiting" && before.waitingFor === "permission";
+      if (activity.state === "working") {
+        if (wasBlocked) told.get(taskId)?.delete("blocked");
+        else if (before?.state !== "working") turnStarted(taskId);
+        return;
+      }
+      if (activity.state !== "waiting") return;
+      if (activity.waitingFor === "permission") {
+        note(taskId, "blocked");
+        return;
+      }
+      if (inTurn.delete(taskId) && !reportedThisTurn.has(taskId)) note(taskId, "turn_unreported");
+    },
+    launchFailed(taskId, reason) {
+      note(taskId, "launch_failed", reason);
+    },
+    exited(taskId) {
+      inTurn.delete(taskId);
+      note(taskId, "exited");
+    },
+    reported(taskId) {
+      reportedThisTurn.add(taskId);
+    },
+    retry(masterId) {
+      if (pending.get(masterId)?.length) schedule(masterId);
+    }
+  };
+}
+
 // packages/core/src/service.ts
 var InvalidRequestError = class extends Error {
   code = "INVALID_REQUEST";
 };
 var STANDALONE_KEY = /^terminal_[0-9a-f-]{36}$/;
+var MAX_MESSAGE_LENGTH = 2e4;
+function coded2(code2, message) {
+  return Object.assign(new Error(message), { code: code2 });
+}
 function invalid(message) {
   throw new InvalidRequestError(message);
 }
@@ -7268,7 +7518,11 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
   const progress = createProgressTracker({
     homeDir: home,
     codexHomes: () => [path24.join(home, ".codex"), ...libraryCodexHome ? [libraryCodexHome] : []],
-    onUpdate: (taskId, value) => bus.emit("progress:update", { taskId, progress: value }),
+    onUpdate: (taskId, value) => {
+      bus.emit("progress:update", { taskId, progress: value });
+      notifier.activity(taskId, value.activity);
+      notifier.retry(taskId);
+    },
     onNotify: (taskId, list) => {
       const prefs = resolveNotificationSettings(getSettings());
       if (!prefs.enabled) return;
@@ -7283,6 +7537,27 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
       bus.emit("progress:notify", { taskId, title: task.title, notifications });
     }
   });
+  const agentActivity = (key) => progress.isTracking(key) ? progress.snapshot(key)?.activity ?? null : null;
+  const mailbox = createMailbox({
+    write: (key, data) => sessions.write(key, data),
+    activity: agentActivity
+  });
+  const notifier = createNotifier({
+    cardOf: (taskId) => {
+      const task = findTask(taskId);
+      return task?.masterId ? { title: task.title, masterId: task.masterId } : null;
+    },
+    canReceive: async (masterId) => {
+      const master = findTask(masterId);
+      if (!master || !isMasterTask(master) || columnOf(master.id) !== "in_progress") return "never";
+      if (!await sessions.isAlive(master.id)) return "later";
+      return isBlocked(agentActivity(master.id)) ? "later" : "yes";
+    },
+    deliver: async (masterId, text) => {
+      await attachAgent(masterId);
+      await mailbox.deliver(masterId, frameMessage(null, text));
+    }
+  });
   function gitWorktree(task) {
     return isMasterTask(task) ? void 0 : task.worktreePath;
   }
@@ -7325,6 +7600,7 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
     standaloneTerminals.delete(key);
     terminalDirectories.delete(key);
     unwatchSubAgents(key);
+    mailbox.forget(key);
   }
   function isStandaloneKey(key) {
     return standaloneTerminals.has(key) || listTerminals().some((t) => t.sessionKey === key);
@@ -7451,6 +7727,7 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
     };
     setBoard(next);
     bus.emit("state:changed", getState());
+    notifier.launchFailed(taskId, launchError);
   }
   let folderDialog = null;
   const github = createGithubService({
@@ -7486,7 +7763,10 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
       cols: typeof p.cols === "number" ? p.cols : void 0,
       rows: typeof p.rows === "number" ? p.rows : void 0,
       // Session ended (natural exit included), so stop its watcher.
-      onExit: () => unwatchSubAgents(key)
+      onExit: () => {
+        unwatchSubAgents(key);
+        if (key === task.id) notifier.exited(task.id);
+      }
     });
     terminalDirectories.set(key, cwd);
     watchSubAgents(key, cwd, (subAgents) => {
@@ -7498,6 +7778,10 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
     }
     return result;
   }
+  async function attachAgent(taskId) {
+    const task = findTask(taskId);
+    if (task && sessions.isAttached?.(taskId) === false) await startTaskSession(task, taskId, { taskId });
+  }
   async function summarizeTasks(filter) {
     const board = getState().board;
     const alive = new Set(await sessions.list());
@@ -7824,12 +8108,30 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
     // Every card on the board, or one master's cards, as the CLI and a master's
     // agent read them.
     "task:summaries": (payload) => {
-      const p = payload === void 0 ? {} : obj(payload, "payload");
+      const p = payload === void 0 || payload === null ? {} : obj(payload, "payload");
       return summarizeTasks({
         masterId: p.masterId === void 0 ? void 0 : requireTask(p.masterId).id,
         taskId: p.taskId === void 0 ? void 0 : requireTask(p.taskId).id
       });
     },
+    // One card's agent talks to another's: a master to its own cards, a card to
+    // its master, nothing else — cards coordinate through their master.
+    "vibeflow:sendMessage": async (payload) => {
+      const p = obj(payload, "payload");
+      const from = findTask(str(p.from, "from"));
+      const to = findTask(str(p.to, "to"));
+      if (!from || !to) throw coded2("UNKNOWN_TASK", `unknown task ${!from ? String(p.from) : String(p.to)}`);
+      const related = isMasterTask(from) && to.masterId === from.id || isMasterTask(to) && from.masterId === to.id;
+      if (!related) throw coded2("NOT_RELATED", "\u53EA\u6709 master \u8207\u5B83\u81EA\u5DF1\u7684\u5361\u7247\u4E4B\u9593\u53EF\u4EE5\u4E92\u50B3\u8A0A\u606F");
+      const text = str(p.text, "text").trim();
+      if (!text) invalid("text must not be empty");
+      if (text.length > MAX_MESSAGE_LENGTH) invalid(`text must be at most ${MAX_MESSAGE_LENGTH} characters`);
+      if (!await sessions.isAlive(to.id)) throw coded2("NOT_RUNNING", `\u5361\u7247 ${to.id} \u7684 agent \u6C92\u6709\u5728\u57F7\u884C`);
+      if (isMasterTask(to)) notifier.reported(from.id);
+      await attachAgent(to.id);
+      const { queuedMs } = await mailbox.deliver(to.id, frameMessage({ id: from.id, title: from.title }, text), { force: p.force === true });
+      return { delivered: true, queuedMs };
+    },
     "terminal:start": async (payload) => {
       const p = obj(payload, "payload");
       const key = str(p.sessionKey, "sessionKey");
@@ -7913,7 +8215,7 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
     },
     "pty:input": (payload) => {
       const p = obj(payload, "payload");
-      sessions.write(requireSessionKey(p.sessionKey), str(p.data, "data"));
+      mailbox.userInput(requireSessionKey(p.sessionKey), str(p.data, "data"));
     },
     "pty:resize": (payload) => {
       const p = obj(payload, "payload");

package/dist/web/404/index.html

@@ -1 +1 @@
-<!DOCTYPE html><html><head><meta charSet="utf-8" data-next-head=""/><meta name="viewport" content="width=device-width" data-next-head=""/><link rel="icon" href="/favicon.ico" sizes="any" data-next-head=""/><link rel="icon" href="/logo.svg" type="image/svg+xml" data-next-head=""/><link rel="apple-touch-icon" href="/apple-touch-icon.png" data-next-head=""/><link rel="manifest" href="/manifest.webmanifest" data-next-head=""/><meta name="theme-color" content="#0d1117" data-next-head=""/><title data-next-head="">404: This page could not be found</title><link rel="preload" href="/_next/static/css/18a64fb6123882cc.css" as="style"/><link rel="stylesheet" href="/_next/static/css/18a64fb6123882cc.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" noModule="" src="/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/_next/static/chunks/webpack-a3102c3e2504881b.js" defer=""></script><script src="/_next/static/chunks/framework-b92a367cf1ad4bf7.js" defer=""></script><script src="/_next/static/chunks/main-ec7fd4c371d06729.js" defer=""></script><script src="/_next/static/chunks/pages/_app-8718d90c431152c1.js" defer=""></script><script src="/_next/static/chunks/pages/_error-8f65b0f8749f42d2.js" defer=""></script><script src="/_next/static/YMl7SPiK7DW5_3Za2vx9B/_buildManifest.js" defer=""></script><script src="/_next/static/YMl7SPiK7DW5_3Za2vx9B/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"YMl7SPiK7DW5_3Za2vx9B","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>
+<!DOCTYPE html><html><head><meta charSet="utf-8" data-next-head=""/><meta name="viewport" content="width=device-width" data-next-head=""/><link rel="icon" href="/favicon.ico" sizes="any" data-next-head=""/><link rel="icon" href="/logo.svg" type="image/svg+xml" data-next-head=""/><link rel="apple-touch-icon" href="/apple-touch-icon.png" data-next-head=""/><link rel="manifest" href="/manifest.webmanifest" data-next-head=""/><meta name="theme-color" content="#0d1117" data-next-head=""/><title data-next-head="">404: This page could not be found</title><link rel="preload" href="/_next/static/css/1b8cc89c93b78db0.css" as="style"/><link rel="stylesheet" href="/_next/static/css/1b8cc89c93b78db0.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" noModule="" src="/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/_next/static/chunks/webpack-9dc72759edb7420f.js" defer=""></script><script src="/_next/static/chunks/framework-b92a367cf1ad4bf7.js" defer=""></script><script src="/_next/static/chunks/main-ec7fd4c371d06729.js" defer=""></script><script src="/_next/static/chunks/pages/_app-ba514e8a4a55baf5.js" defer=""></script><script src="/_next/static/chunks/pages/_error-8f65b0f8749f42d2.js" defer=""></script><script src="/_next/static/wFlo60T-hKTrS3FBCZ5OJ/_buildManifest.js" defer=""></script><script src="/_next/static/wFlo60T-hKTrS3FBCZ5OJ/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"wFlo60T-hKTrS3FBCZ5OJ","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>

package/dist/web/404.html

@@ -1 +1 @@
-<!DOCTYPE html><html><head><meta charSet="utf-8" data-next-head=""/><meta name="viewport" content="width=device-width" data-next-head=""/><link rel="icon" href="/favicon.ico" sizes="any" data-next-head=""/><link rel="icon" href="/logo.svg" type="image/svg+xml" data-next-head=""/><link rel="apple-touch-icon" href="/apple-touch-icon.png" data-next-head=""/><link rel="manifest" href="/manifest.webmanifest" data-next-head=""/><meta name="theme-color" content="#0d1117" data-next-head=""/><title data-next-head="">404: This page could not be found</title><link rel="preload" href="/_next/static/css/18a64fb6123882cc.css" as="style"/><link rel="stylesheet" href="/_next/static/css/18a64fb6123882cc.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" noModule="" src="/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/_next/static/chunks/webpack-a3102c3e2504881b.js" defer=""></script><script src="/_next/static/chunks/framework-b92a367cf1ad4bf7.js" defer=""></script><script src="/_next/static/chunks/main-ec7fd4c371d06729.js" defer=""></script><script src="/_next/static/chunks/pages/_app-8718d90c431152c1.js" defer=""></script><script src="/_next/static/chunks/pages/_error-8f65b0f8749f42d2.js" defer=""></script><script src="/_next/static/YMl7SPiK7DW5_3Za2vx9B/_buildManifest.js" defer=""></script><script src="/_next/static/YMl7SPiK7DW5_3Za2vx9B/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"YMl7SPiK7DW5_3Za2vx9B","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>
+<!DOCTYPE html><html><head><meta charSet="utf-8" data-next-head=""/><meta name="viewport" content="width=device-width" data-next-head=""/><link rel="icon" href="/favicon.ico" sizes="any" data-next-head=""/><link rel="icon" href="/logo.svg" type="image/svg+xml" data-next-head=""/><link rel="apple-touch-icon" href="/apple-touch-icon.png" data-next-head=""/><link rel="manifest" href="/manifest.webmanifest" data-next-head=""/><meta name="theme-color" content="#0d1117" data-next-head=""/><title data-next-head="">404: This page could not be found</title><link rel="preload" href="/_next/static/css/1b8cc89c93b78db0.css" as="style"/><link rel="stylesheet" href="/_next/static/css/1b8cc89c93b78db0.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" noModule="" src="/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/_next/static/chunks/webpack-9dc72759edb7420f.js" defer=""></script><script src="/_next/static/chunks/framework-b92a367cf1ad4bf7.js" defer=""></script><script src="/_next/static/chunks/main-ec7fd4c371d06729.js" defer=""></script><script src="/_next/static/chunks/pages/_app-ba514e8a4a55baf5.js" defer=""></script><script src="/_next/static/chunks/pages/_error-8f65b0f8749f42d2.js" defer=""></script><script src="/_next/static/wFlo60T-hKTrS3FBCZ5OJ/_buildManifest.js" defer=""></script><script src="/_next/static/wFlo60T-hKTrS3FBCZ5OJ/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"wFlo60T-hKTrS3FBCZ5OJ","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>