@agenticmail/claudecode 0.1.8 → 0.1.9

package/dist/{chunk-M5HV2M67.js → chunk-3D5VXS5Y.js}

@@ -187,7 +187,7 @@ function renderPersonaBody(input) {
     `  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.`,
+    `  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? **If a teammate replied within the last 60 seconds, assume they are handling this turn and stay silent** \u2014 simultaneous replies are noise. 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.`,
     "",

package/dist/{chunk-V5LH4BNZ.js → chunk-52LXPWO7.js}

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

package/dist/{chunk-JVDPUO35.js → chunk-CQLUFM7N.js}

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

package/dist/{chunk-5HUEJNT5.js → chunk-FBO6F4IC.js}

@@ -2,7 +2,7 @@ import {
   listAccounts,
   renderPersonaBody,
   resolveConfig
-} from "./chunk-M5HV2M67.js";
+} from "./chunk-3D5VXS5Y.js";
 
 // src/persona-loader.ts
 import { existsSync, readFileSync } from "fs";
@@ -72,6 +72,18 @@ function isTaskNotificationSubject(subject) {
   }
   return false;
 }
+function threadIdFromSubject(subject) {
+  if (!subject) return "";
+  let s = subject.trim();
+  while (true) {
+    const next = s.replace(/^(re|fwd?|fw)(\[\d+\])?:\s*/i, "");
+    if (next === s) break;
+    s = next;
+  }
+  return s.toLowerCase().trim();
+}
+var DEFAULT_MAX_WAKES_PER_THREAD = 10;
+var DEFAULT_WAKE_WINDOW_MS = 24 * 60 * 60 * 1e3;
 async function runWorker(query, persona, userPrompt, agent, mcpServerName, mcpCommand, mcpArgs, mcpEnv, log, abortSignal) {
   const opts = {
     systemPrompt: persona,
@@ -168,6 +180,10 @@ function newMailPrompt(agent, event) {
     `     - 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).`,
+    `     - **A teammate replied within the last 60 seconds.** They are likely`,
+    `       already handling this turn; jumping in creates simultaneous replies`,
+    `       and confusion. Assume good faith and stay silent unless their reply`,
+    `       was clearly off-target.`,
     `     - 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.`,
@@ -239,6 +255,15 @@ var Dispatcher = class {
   running = 0;
   waiters = [];
   stopped = false;
+  /**
+   * Wake-budget store, keyed by `${accountId}::${threadId}`. See the
+   * comment block on WakeBudgetEntry for the failure modes this guards.
+   * Pruned opportunistically on each lookup — no separate timer.
+   */
+  wakeBudget = /* @__PURE__ */ new Map();
+  maxWakesPerThread;
+  wakeWindowMs;
+  now;
   constructor(opts = {}) {
     this.cfg = resolveConfig(opts);
     this.maxConcurrent = opts.maxConcurrentWorkers ?? DEFAULT_MAX_CONCURRENT;
@@ -248,10 +273,63 @@ var Dispatcher = class {
     this.query = opts.querySdk ?? defaultQuery();
     this.fetchImpl = opts.fetchImpl ?? globalThis.fetch;
     this.log = opts.log ?? defaultLog;
+    this.maxWakesPerThread = opts.maxWakesPerThread ?? DEFAULT_MAX_WAKES_PER_THREAD;
+    this.wakeWindowMs = opts.wakeWindowMs ?? DEFAULT_WAKE_WINDOW_MS;
+    this.now = opts.nowMs ?? Date.now;
     if (!this.cfg.masterKey) {
       throw new Error("Dispatcher requires AgenticMail master key. Run `agenticmail setup` first.");
     }
   }
+  /**
+   * Charge one wake against the (agent, thread) budget. Returns true
+   * if the wake should proceed, false if the circuit breaker is open.
+   *
+   * Empty threadId means "no thread context" (a fresh standalone email
+   * with no Subject — rare); we always allow those since there is no
+   * thread to runaway on.
+   */
+  chargeWake(accountId, threadId) {
+    if (!threadId) return { ok: true };
+    const key = `${accountId}::${threadId}`;
+    const now = this.now();
+    let entry = this.wakeBudget.get(key);
+    if (entry && now - entry.firstWakeAtMs >= this.wakeWindowMs) {
+      entry = void 0;
+      this.wakeBudget.delete(key);
+    }
+    if (!entry) {
+      entry = { count: 1, firstWakeAtMs: now };
+      this.wakeBudget.set(key, entry);
+      this.maybePruneWakeBudget(now);
+      return { ok: true, count: 1 };
+    }
+    if (entry.count >= this.maxWakesPerThread) {
+      return {
+        ok: false,
+        count: entry.count,
+        mutedUntilMs: entry.firstWakeAtMs + this.wakeWindowMs
+      };
+    }
+    entry.count++;
+    return { ok: true, count: entry.count };
+  }
+  /**
+   * Drop wake-budget entries that have aged out of their window.
+   *
+   * Called inline from chargeWake, but at most once per ~1024 inserts so
+   * the cost stays bounded. We don't need a separate timer because the
+   * Map only grows on real wakes (capped by maxWakesPerThread per pair),
+   * and the prune is O(n) over the current entries — cheap enough.
+   */
+  wakeBudgetInsertsSinceLastPrune = 0;
+  maybePruneWakeBudget(now) {
+    this.wakeBudgetInsertsSinceLastPrune++;
+    if (this.wakeBudgetInsertsSinceLastPrune < 1024) return;
+    this.wakeBudgetInsertsSinceLastPrune = 0;
+    for (const [k, v] of this.wakeBudget) {
+      if (now - v.firstWakeAtMs >= this.wakeWindowMs) this.wakeBudget.delete(k);
+    }
+  }
   async start() {
     this.log("info", `[dispatcher] starting (maxConcurrent=${this.maxConcurrent}, syncEvery=${this.syncIntervalMs}ms)`);
     await this.syncAccounts();
@@ -291,6 +369,13 @@ var Dispatcher = class {
         return;
       }
       if (ch) rememberBounded(ch.seenUids, event.uid);
+      const threadId = threadIdFromSubject(subject);
+      const verdict = this.chargeWake(account.id, threadId);
+      if (!verdict.ok) {
+        const minutesUntil = verdict.mutedUntilMs ? Math.max(0, Math.round((verdict.mutedUntilMs - this.now()) / 6e4)) : 0;
+        this.log("warn", `[dispatcher] wake-budget exhausted for "${account.name}" on thread "${threadId}" (count=${verdict.count}, cap=${this.maxWakesPerThread}); muted for ~${minutesUntil}min. uid=${event.uid}, subject="${subject ?? ""}"`);
+        return;
+      }
       await this.spawnWorker(account, newMailPrompt(account, event), { kind: "new-mail", uid: event.uid });
       return;
     }

package/dist/{chunk-VYBBCFP5.js → chunk-V3QMDNTR.js}

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

package/dist/{chunk-XHDRGX46.js → chunk-WAUWKOHA.js}

@@ -1,15 +1,15 @@
 import {
   install
-} from "./chunk-V5LH4BNZ.js";
+} from "./chunk-52LXPWO7.js";
 import {
   status
-} from "./chunk-VYBBCFP5.js";
+} from "./chunk-V3QMDNTR.js";
 import {
   uninstall
-} from "./chunk-JVDPUO35.js";
+} from "./chunk-CQLUFM7N.js";
 import {
   AgenticMailApiError
-} from "./chunk-M5HV2M67.js";
+} from "./chunk-3D5VXS5Y.js";
 
 // src/http-routes.ts
 import { Router } from "express";

package/dist/cli.js

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   install
-} from "./chunk-V5LH4BNZ.js";
+} from "./chunk-52LXPWO7.js";
 import {
   status
-} from "./chunk-VYBBCFP5.js";
+} from "./chunk-V3QMDNTR.js";
 import {
   uninstall
-} from "./chunk-JVDPUO35.js";
+} from "./chunk-CQLUFM7N.js";
 import "./chunk-US5FT2UB.js";
 import {
   AgenticMailApiError
-} from "./chunk-M5HV2M67.js";
+} from "./chunk-3D5VXS5Y.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-5HUEJNT5.js";
-import "./chunk-M5HV2M67.js";
+} from "./chunk-FBO6F4IC.js";
+import "./chunk-3D5VXS5Y.js";
 
 // src/dispatcher-bin.ts
 async function main() {

package/dist/dispatcher.d.ts

@@ -73,6 +73,20 @@ interface DispatcherOptions extends ResolveConfigOptions {
     sseReconnectBaseMs?: number;
     /** Max backoff between SSE reconnect attempts. Default 60s. */
     sseReconnectMaxMs?: number;
+    /**
+     * Max times a single agent is woken on the same thread before the
+     * circuit breaker trips. Default 10. Protects against reply loops,
+     * storms when many agents share a thread, and stuck agents that
+     * keep replying without making progress. Per-(agent, thread).
+     */
+    maxWakesPerThread?: number;
+    /**
+     * Window (ms) for the per-thread wake counter. Default 24h. The
+     * counter resets after this period elapses since the FIRST wake in
+     * the window — wall-clock-relative, not sliding, so a runaway
+     * thread stays muted for the full period (which is what we want).
+     */
+    wakeWindowMs?: number;
     /** Override the Claude Agent SDK `query` function. Used by tests. */
     querySdk?: QueryFn;
     /** Override the global `fetch`. Used by tests. */
@@ -80,6 +94,8 @@ interface DispatcherOptions extends ResolveConfigOptions {
     /** Override the global EventSource. Optional — we don't use EventSource
      *  by default (fetch + reader is simpler). */
     log?: (level: 'info' | 'warn' | 'error', msg: string) => void;
+    /** Override Date.now() — tests use this to advance the budget clock. */
+    nowMs?: () => number;
 }
 /** Minimal Claude Agent SDK query signature we use. */
 interface QueryFn {
@@ -107,7 +123,35 @@ declare class Dispatcher {
     private running;
     private waiters;
     private stopped;
+    /**
+     * Wake-budget store, keyed by `${accountId}::${threadId}`. See the
+     * comment block on WakeBudgetEntry for the failure modes this guards.
+     * Pruned opportunistically on each lookup — no separate timer.
+     */
+    private wakeBudget;
+    private maxWakesPerThread;
+    private wakeWindowMs;
+    private now;
     constructor(opts?: DispatcherOptions);
+    /**
+     * Charge one wake against the (agent, thread) budget. Returns true
+     * if the wake should proceed, false if the circuit breaker is open.
+     *
+     * Empty threadId means "no thread context" (a fresh standalone email
+     * with no Subject — rare); we always allow those since there is no
+     * thread to runaway on.
+     */
+    private chargeWake;
+    /**
+     * Drop wake-budget entries that have aged out of their window.
+     *
+     * Called inline from chargeWake, but at most once per ~1024 inserts so
+     * the cost stays bounded. We don't need a separate timer because the
+     * Map only grows on real wakes (capped by maxWakesPerThread per pair),
+     * and the prune is O(n) over the current entries — cheap enough.
+     */
+    private wakeBudgetInsertsSinceLastPrune;
+    private maybePruneWakeBudget;
     start(): Promise<void>;
     stop(): Promise<void>;
     /** Public for tests — directly hand an event to the routing path. */

package/dist/dispatcher.js

@@ -1,7 +1,7 @@
 import {
   Dispatcher
-} from "./chunk-5HUEJNT5.js";
-import "./chunk-M5HV2M67.js";
+} from "./chunk-FBO6F4IC.js";
+import "./chunk-3D5VXS5Y.js";
 export {
   Dispatcher
 };

package/dist/http-routes.js

@@ -1,11 +1,11 @@
 import {
   createIntegrationRoutes
-} from "./chunk-XHDRGX46.js";
-import "./chunk-V5LH4BNZ.js";
-import "./chunk-VYBBCFP5.js";
-import "./chunk-JVDPUO35.js";
+} from "./chunk-WAUWKOHA.js";
+import "./chunk-52LXPWO7.js";
+import "./chunk-V3QMDNTR.js";
+import "./chunk-CQLUFM7N.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-M5HV2M67.js";
+import "./chunk-3D5VXS5Y.js";
 export {
   createIntegrationRoutes
 };

package/dist/index.js

@@ -1,19 +1,19 @@
 import {
   Dispatcher,
   loadPersonaForAgent
-} from "./chunk-5HUEJNT5.js";
+} from "./chunk-FBO6F4IC.js";
 import {
   createIntegrationRoutes
-} from "./chunk-XHDRGX46.js";
+} from "./chunk-WAUWKOHA.js";
 import {
   install
-} from "./chunk-V5LH4BNZ.js";
+} from "./chunk-52LXPWO7.js";
 import {
   status
-} from "./chunk-VYBBCFP5.js";
+} from "./chunk-V3QMDNTR.js";
 import {
   uninstall
-} from "./chunk-JVDPUO35.js";
+} from "./chunk-CQLUFM7N.js";
 import "./chunk-US5FT2UB.js";
 import {
   AgenticMailApiError,
@@ -26,7 +26,7 @@ import {
   renderPersonaBody,
   renderSubagentMarkdown,
   resolveConfig
-} from "./chunk-M5HV2M67.js";
+} from "./chunk-3D5VXS5Y.js";
 export {
   AgenticMailApiError,
   Dispatcher,

package/dist/install.js

@@ -1,9 +1,9 @@
 import {
   install,
   selectExposableAgents
-} from "./chunk-V5LH4BNZ.js";
+} from "./chunk-52LXPWO7.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-M5HV2M67.js";
+import "./chunk-3D5VXS5Y.js";
 export {
   install,
   selectExposableAgents

package/dist/status.js

@@ -1,8 +1,8 @@
 import {
   status
-} from "./chunk-VYBBCFP5.js";
+} from "./chunk-V3QMDNTR.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-M5HV2M67.js";
+import "./chunk-3D5VXS5Y.js";
 export {
   status
 };

package/dist/uninstall.js

@@ -1,8 +1,8 @@
 import {
   uninstall
-} from "./chunk-JVDPUO35.js";
+} from "./chunk-CQLUFM7N.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-M5HV2M67.js";
+import "./chunk-3D5VXS5Y.js";
 export {
   uninstall
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/claudecode",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "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",