@agenticmail/claudecode 0.1.5 → 0.1.6

package/dist/{chunk-3ULRGCUI.js → chunk-5M43V6CB.js}

@@ -2,7 +2,7 @@ import {
   listAccounts,
   renderPersonaBody,
   resolveConfig
-} from "./chunk-W2R3GH54.js";
+} from "./chunk-YWSO3QOQ.js";
 
 // src/persona-loader.ts
 import { existsSync, readFileSync } from "fs";
@@ -59,7 +59,7 @@ function rememberBounded(set, item) {
   }
 }
 var DEFAULT_MAX_CONCURRENT = 10;
-var DEFAULT_SYNC_INTERVAL_MS = 6e4;
+var DEFAULT_SYNC_INTERVAL_MS = 5e3;
 var DEFAULT_RECONNECT_BASE_MS = 2e3;
 var DEFAULT_RECONNECT_MAX_MS = 6e4;
 var TASK_MAIL_SUPPRESS_WINDOW_MS = 3e4;
@@ -94,6 +94,7 @@ async function runWorker(query, persona, userPrompt, agent, mcpServerName, mcpCo
       `mcp__${mcpServerName}__list_agents`,
       `mcp__${mcpServerName}__message_agent`,
       `mcp__${mcpServerName}__call_agent`,
+      `mcp__${mcpServerName}__wait_for_email`,
       `mcp__${mcpServerName}__check_tasks`,
       `mcp__${mcpServerName}__claim_task`,
       `mcp__${mcpServerName}__submit_result`,
@@ -143,13 +144,55 @@ function newMailPrompt(agent, event) {
     `- Subject: ${subject}`,
     uid ? `- UID: ${uid}` : "",
     ``,
-    `Open it (with read_email if a UID was given, or list_inbox otherwise), decide what to do as ${agent.name} would, and act:`,
-    `  - if it's a question or request \u2192 reply with reply_email`,
-    `  - if it requires research \u2192 use call_agent to ask the right teammate, then reply`,
-    `  - if it's an FYI \u2192 archive (mark_read) and move on`,
-    `  - if it's spam-looking \u2192 trust the auto-spam-filter; only intervene if it slipped through`,
+    `## Thread-aware coordination protocol`,
     ``,
-    `When you've handled it, return a one-line summary of what you did.`
+    `You are ${agent.name}. Multiple agents may be CC'd on the same thread \u2014`,
+    `that is intentional: a thread is the shared workspace, and turn-taking is`,
+    `implicit from context (who was addressed last, whose stage of the workflow`,
+    `is next, who was @mentioned). Follow these steps in order:`,
+    ``,
+    `1. **Read this message.** read_email({ uid: ${uid ?? "<uid>"}, _account: "${agent.name}" }).`,
+    ``,
+    `2. **If this is a reply (Subject starts with "Re:" or an In-Reply-To header is present), load the rest of the thread.**`,
+    `   Use search_emails({ subject: "<core subject without Re:>", _account: "${agent.name}" })`,
+    `   to surface earlier messages in the thread, then read_email each prior UID.`,
+    `   You MUST read the full thread before deciding what to do.`,
+    ``,
+    `3. **Identify the participants.** Look at To + CC across the thread. Those`,
+    `   are your collaborators. Their names map to AgenticMail agents at`,
+    `   <name>@localhost. They will each be woken on every reply-all the same way you were.`,
+    ``,
+    `4. **Decide: is it MY turn?** Yes if any of:`,
+    `     - The latest message addresses you by name ("Vesper, please \u2026", "@${agent.name} \u2026").`,
+    `     - The previous-stage handoff is to your role (e.g. designer \u2192 developer, and you are the developer).`,
+    `     - You were directly asked a question and nobody has answered yet.`,
+    `   No if:`,
+    `     - The current ask is targeted at a teammate (their turn, not yours).`,
+    `     - You have nothing substantive to add right now.`,
+    `   When in doubt, stay silent \u2014 over-replying creates noise. Better to let`,
+    `   the right teammate take the turn than to step on theirs.`,
+    ``,
+    `5. **If it's your turn \u2014 reply-all so the whole thread sees it.**`,
+    `   reply_email({ uid: ${uid ?? "<uid>"}, replyAll: true, text: "...", _account: "${agent.name}" })`,
+    `   Sign with your name. Be substantive but concise. If you are handing off`,
+    `   to the next teammate, name them explicitly in your reply ("Orion \u2014 over to you, please \u2026").`,
+    ``,
+    `6. **If you need additional help from a teammate not yet on the thread,**`,
+    `   include them by CC'ing in your reply-all \u2014 DO NOT spin up a separate`,
+    `   call_agent / message_agent side-channel. The thread is the workspace;`,
+    `   everyone stays in context.`,
+    ``,
+    `7. **If it's NOT your turn,** mark the message read with mark_read and return.`,
+    `   Do not reply just to acknowledge. Silence IS a valid contribution.`,
+    ``,
+    `When you finish, return a one-line summary of what you did:`,
+    `  "Contributed: <one-line description>"  OR  "Stayed silent \u2014 not my turn."`,
+    ``,
+    `## Fallback for non-thread mail`,
+    ``,
+    `If this is a fresh standalone email (not part of a thread, only addressed`,
+    `to you), handle it directly: answer the question, do the work, reply.`,
+    `Spam: trust the auto-filter unless something obviously slipped through.`
   ].filter(Boolean).join("\n");
 }
 function taskPrompt(agent, event) {
@@ -248,6 +291,29 @@ var Dispatcher = class {
       return;
     }
   }
+  /**
+   * Should the dispatcher own a wake-channel for this account?
+   *
+   * We skip the bridge agent (default name "claudecode"). The bridge is
+   * the host session's own inbox proxy — when mail lands there, the
+   * HOST Claude Code session reads it via MCP (`list_inbox` /
+   * `wait_for_email` / `read_email`), NOT via a separately-spawned
+   * dispatcher worker. Spawning a worker for the bridge would:
+   *   1. Compete with the host (two Claude instances trying to "be"
+   *      Claude Code, both potentially replying autonomously).
+   *   2. Waste tokens — the host is already aware via its MCP polling.
+   *   3. Send the bridge into an autonomous loop if it ever replies-all
+   *      (because that mail would wake it again, ad infinitum).
+   *
+   * Role="bridge" is also skipped for symmetry with selectExposableAgents
+   * in install.ts — anything tagged as a bridge is host-managed.
+   */
+  shouldWatch(account) {
+    const bridgeName = this.cfg.bridgeAgentName.toLowerCase();
+    if (account.name.toLowerCase() === bridgeName) return false;
+    if (account.role === "bridge") return false;
+    return true;
+  }
   /** Re-fetch /accounts; open SSE for new ones, close for vanished ones. */
   async syncAccounts() {
     let accounts;
@@ -257,6 +323,7 @@ var Dispatcher = class {
       this.log("warn", `[dispatcher] could not list accounts: ${err.message}`);
       return;
     }
+    accounts = accounts.filter((a) => this.shouldWatch(a));
     const liveIds = new Set(accounts.map((a) => a.id));
     for (const [id, ch] of this.channels) {
       if (!liveIds.has(id)) {

package/dist/{chunk-OZPRB336.js → chunk-N43A7EQB.js}

@@ -1,15 +1,15 @@
 import {
   install
-} from "./chunk-4JURQ6QD.js";
+} from "./chunk-WP2ELPRM.js";
 import {
   status
-} from "./chunk-UZZNLWBR.js";
+} from "./chunk-UC63VEBP.js";
 import {
   uninstall
-} from "./chunk-5S377IWV.js";
+} from "./chunk-XGBVWZ3M.js";
 import {
   AgenticMailApiError
-} from "./chunk-W2R3GH54.js";
+} from "./chunk-YWSO3QOQ.js";
 
 // src/http-routes.ts
 import { Router } from "express";

package/dist/{chunk-UZZNLWBR.js → chunk-UC63VEBP.js}

@@ -7,7 +7,7 @@ import {
   MANAGED_BY_MARKER,
   getAccountByName,
   resolveConfig
-} from "./chunk-W2R3GH54.js";
+} from "./chunk-YWSO3QOQ.js";
 
 // src/status.ts
 import { existsSync, readFileSync, readdirSync } from "fs";

package/dist/{chunk-4JURQ6QD.js → chunk-WP2ELPRM.js}

@@ -9,7 +9,7 @@ import {
   listAccounts,
   renderSubagentMarkdown,
   resolveConfig
-} from "./chunk-W2R3GH54.js";
+} from "./chunk-YWSO3QOQ.js";
 
 // src/install.ts
 import { existsSync, mkdirSync, readdirSync, writeFileSync, readFileSync, unlinkSync } from "fs";

package/dist/{chunk-5S377IWV.js → chunk-XGBVWZ3M.js}

@@ -7,7 +7,7 @@ import {
   deleteAccount,
   getAccountByName,
   resolveConfig
-} from "./chunk-W2R3GH54.js";
+} from "./chunk-YWSO3QOQ.js";
 
 // src/uninstall.ts
 import { existsSync, readdirSync, readFileSync, unlinkSync } from "fs";

package/dist/{chunk-W2R3GH54.js → chunk-YWSO3QOQ.js}

@@ -130,12 +130,16 @@ var ESSENTIAL_TOOL_NAMES = [
   "search_emails",
   "list_agents",
   "message_agent",
-  // call_agent is the synchronous RPC primitive — fire a task at another
-  // AgenticMail agent and get back a structured result. It is the reason
-  // multi-agent setups work, so it MUST be pre-loaded; making subagents
-  // call request_tools just to discover it would be a usability disaster
-  // for the most common coordination pattern.
+  // call_agent is the one-shot RPC primitive — sync request, sync answer.
+  // For multi-step coordination use the thread pattern (send_email with
+  // CC + reply_email with replyAll) instead.
   "call_agent",
+  // wait_for_email is the thread-coordination primitive: block until a
+  // specific reply lands in your inbox (filter by from / subject /
+  // inReplyTo / participants). Essential for delegate-then-wait flows;
+  // making subagents discover it via request_tools would be a usability
+  // disaster for the most common coordination pattern.
+  "wait_for_email",
   "check_tasks",
   // Meta-tools — these unlock the other ~50 tools on demand.
   "request_tools",
@@ -201,7 +205,16 @@ function renderPersonaBody(input) {
     `${tool("whoami")}({ _account: "${agent.name}" })`,
     "```",
     "",
-    `**Coordination tip:** When you need another agent to *do work and report back*, prefer \`${tool("call_agent")}\` over \`${tool("message_agent")}\`. message_agent just delivers an email and returns immediately; call_agent runs the AgenticMail RPC pipeline \u2014 the target agent gets the task, processes it, and the structured result flows back into your call. That is the entire reason this platform has multiple agents.`,
+    `**Coordination \u2014 the thread is the workspace.** When you wake on new mail and it's part of a thread (Subject starts with "Re:" or an In-Reply-To header is present):`,
+    "",
+    `  1. Read the new message with \`${tool("read_email")}\`.`,
+    `  2. Load the rest of the thread with \`${tool("search_emails")}({ subject: "<core subject>", _account: "${agent.name}" })\` and read each prior message. You MUST have full thread context before acting.`,
+    `  3. Look at To + CC across the thread \u2014 those are your teammates. They will each be woken on every reply-all just like you were.`,
+    `  4. Decide if it's YOUR turn: are you addressed by name? Is the previous-stage handoff to your role? Is a question pending for you? When in doubt, stay silent \u2014 over-replying creates noise.`,
+    `  5. If yes: \`${tool("reply_email")}({ uid, replyAll: true, text: "...", _account: "${agent.name}" })\`. Sign with your name. If you're handing off, name the next teammate explicitly ("Orion \u2014 over to you, please \u2026"). To bring a new teammate in, just add them to CC.`,
+    `  6. If no: \`mark_read\` and return. Silence IS a valid contribution.`,
+    "",
+    `**When to use \`${tool("call_agent")}\` instead:** only when you need ONE structured answer from ONE teammate, inline in your current turn \u2014 e.g. "give me a JSON list of X". For multi-step / multi-agent work, the thread pattern above is the right primitive.`,
     "",
     `On-demand (via invoke) examples \u2014 anything NOT in the pre-loaded list:`,
     "",

package/dist/cli.js

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   install
-} from "./chunk-4JURQ6QD.js";
+} from "./chunk-WP2ELPRM.js";
 import {
   status
-} from "./chunk-UZZNLWBR.js";
+} from "./chunk-UC63VEBP.js";
 import {
   uninstall
-} from "./chunk-5S377IWV.js";
+} from "./chunk-XGBVWZ3M.js";
 import "./chunk-US5FT2UB.js";
 import {
   AgenticMailApiError
-} from "./chunk-W2R3GH54.js";
+} from "./chunk-YWSO3QOQ.js";
 
 // src/cli.ts
 var GREEN = (s) => `\x1B[32m${s}\x1B[0m`;

package/dist/dispatcher-bin.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   Dispatcher
-} from "./chunk-3ULRGCUI.js";
-import "./chunk-W2R3GH54.js";
+} from "./chunk-5M43V6CB.js";
+import "./chunk-YWSO3QOQ.js";
 
 // src/dispatcher-bin.ts
 async function main() {

package/dist/dispatcher.d.ts

@@ -111,6 +111,24 @@ declare class Dispatcher {
     stop(): Promise<void>;
     /** Public for tests — directly hand an event to the routing path. */
     handleEvent(account: AgenticMailAccount, event: SSEEvent): Promise<void>;
+    /**
+     * Should the dispatcher own a wake-channel for this account?
+     *
+     * We skip the bridge agent (default name "claudecode"). The bridge is
+     * the host session's own inbox proxy — when mail lands there, the
+     * HOST Claude Code session reads it via MCP (`list_inbox` /
+     * `wait_for_email` / `read_email`), NOT via a separately-spawned
+     * dispatcher worker. Spawning a worker for the bridge would:
+     *   1. Compete with the host (two Claude instances trying to "be"
+     *      Claude Code, both potentially replying autonomously).
+     *   2. Waste tokens — the host is already aware via its MCP polling.
+     *   3. Send the bridge into an autonomous loop if it ever replies-all
+     *      (because that mail would wake it again, ad infinitum).
+     *
+     * Role="bridge" is also skipped for symmetry with selectExposableAgents
+     * in install.ts — anything tagged as a bridge is host-managed.
+     */
+    private shouldWatch;
     /** Re-fetch /accounts; open SSE for new ones, close for vanished ones. */
     private syncAccounts;
     /** Watch one account's SSE stream forever; reconnect with backoff on drop. */

package/dist/dispatcher.js

@@ -1,7 +1,7 @@
 import {
   Dispatcher
-} from "./chunk-3ULRGCUI.js";
-import "./chunk-W2R3GH54.js";
+} from "./chunk-5M43V6CB.js";
+import "./chunk-YWSO3QOQ.js";
 export {
   Dispatcher
 };

package/dist/http-routes.js

@@ -1,11 +1,11 @@
 import {
   createIntegrationRoutes
-} from "./chunk-OZPRB336.js";
-import "./chunk-4JURQ6QD.js";
-import "./chunk-UZZNLWBR.js";
-import "./chunk-5S377IWV.js";
+} from "./chunk-N43A7EQB.js";
+import "./chunk-WP2ELPRM.js";
+import "./chunk-UC63VEBP.js";
+import "./chunk-XGBVWZ3M.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-W2R3GH54.js";
+import "./chunk-YWSO3QOQ.js";
 export {
   createIntegrationRoutes
 };

package/dist/index.js

@@ -1,19 +1,19 @@
 import {
   Dispatcher,
   loadPersonaForAgent
-} from "./chunk-3ULRGCUI.js";
+} from "./chunk-5M43V6CB.js";
 import {
   createIntegrationRoutes
-} from "./chunk-OZPRB336.js";
+} from "./chunk-N43A7EQB.js";
 import {
   install
-} from "./chunk-4JURQ6QD.js";
+} from "./chunk-WP2ELPRM.js";
 import {
   status
-} from "./chunk-UZZNLWBR.js";
+} from "./chunk-UC63VEBP.js";
 import {
   uninstall
-} from "./chunk-5S377IWV.js";
+} from "./chunk-XGBVWZ3M.js";
 import "./chunk-US5FT2UB.js";
 import {
   AgenticMailApiError,
@@ -26,7 +26,7 @@ import {
   renderPersonaBody,
   renderSubagentMarkdown,
   resolveConfig
-} from "./chunk-W2R3GH54.js";
+} from "./chunk-YWSO3QOQ.js";
 export {
   AgenticMailApiError,
   Dispatcher,

package/dist/install.js

@@ -1,9 +1,9 @@
 import {
   install,
   selectExposableAgents
-} from "./chunk-4JURQ6QD.js";
+} from "./chunk-WP2ELPRM.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-W2R3GH54.js";
+import "./chunk-YWSO3QOQ.js";
 export {
   install,
   selectExposableAgents

package/dist/status.js

@@ -1,8 +1,8 @@
 import {
   status
-} from "./chunk-UZZNLWBR.js";
+} from "./chunk-UC63VEBP.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-W2R3GH54.js";
+import "./chunk-YWSO3QOQ.js";
 export {
   status
 };

package/dist/uninstall.js

@@ -1,8 +1,8 @@
 import {
   uninstall
-} from "./chunk-5S377IWV.js";
+} from "./chunk-XGBVWZ3M.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-W2R3GH54.js";
+import "./chunk-YWSO3QOQ.js";
 export {
   uninstall
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/claudecode",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Claude Code integration for AgenticMail — surfaces every AgenticMail agent as a native Claude Code subagent so any Claude Code session can delegate to them with the Agent tool",
   "type": "module",
   "main": "dist/index.js",