@agenticmail/claudecode 0.2.13 → 0.2.14

package/dist/{chunk-UI556UPF.js → chunk-GVR4HTBB.js}

@@ -234,7 +234,26 @@ function renderPersonaBody(input) {
     `  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. **Check your prior contributions first.** In the search results from step 2, count how many messages are from \`${agent.email}\`. If you have already contributed your work to this thread, do NOT redo it on a new wake. Only re-contribute if (a) the latest reply has a NEW specific ask for you by name and you have not yet answered THAT ask, or (b) a teammate's reply genuinely changes the picture and your prior work needs an explicit revision. Redelivering the same content when a teammate posts an update is the most common multi-agent failure mode.`,
     `  5. 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.`,
-    `  6. 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 yes: \`${tool("reply_email")}({ uid, replyAll: true, text: "...", _account: "${agent.name}" })\`. Sign with your name.`,
+    "",
+    `     **HANDOFFS \u2014 read this carefully.** When you're delegating the next step to ONE specific teammate, you MUST pass \`wake: ["<their-name>"]\` in the same call. Reason: a reply-all keeps the ORIGINAL sender on the \`To:\` header, NOT your handoff target. So if Vesper just replied to the thread and you reply-all saying "Atlas \u2014 over to you", the resulting email lands with \`To: vesper\`, \`Cc: orion, atlas, ...\`. Without an explicit \`wake\`, every CC'd teammate gets a turn (cost), the dispatcher has no signal that Atlas is the assignee, and Atlas may stay silent assuming another teammate already took it \u2014 which is what the user calls "killing the task mid-work". \`wake: ["atlas"]\` is the authoritative signal: only Atlas thinks next, everyone else still receives the mail and stays informed. The body text is for humans + audit trail; the \`wake\` array is for the dispatcher.`,
+    "",
+    `     **Examples.**`,
+    "",
+    "```",
+    `// Handing the next step to Atlas \u2014 Atlas wakes, everyone else stays informed but quiet.`,
+    `${tool("reply_email")}({ uid: 42, replyAll: true, _account: "${agent.name}",`,
+    `  text: "Atlas \u2014 over to you. Spec is shared/slice-4-probe-spec.md. ...",`,
+    `  wake: ["atlas"] })`,
+    ``,
+    `// Broadcasting an update no specific teammate needs to act on \u2014 silent delivery.`,
+    `${tool("reply_email")}({ uid: 42, replyAll: true, _account: "${agent.name}",`,
+    `  text: "Status: design doc is finalised at v2 \u2014 link below.",`,
+    `  wake: [] })`,
+    `// (\`wake: []\` = "I'm broadcasting; nobody needs to wake on this.")`,
+    "```",
+    "",
+    `     To bring a brand-new teammate into the thread, add them to CC AND name them in \`wake\`.`,
     `  7. If no: \`mark_read\` and return. Silence IS a valid contribution.`,
     "",
     `**Closing a thread.** When the work is genuinely done and no more contributions are needed, send a wrap-up reply with one of these markers in the subject: \`[FINAL]\`, \`[DONE]\`, \`[CLOSED]\`, or \`[WRAP]\`. The dispatcher honours those markers and stops waking workers on any further replies to that thread. Use this when YOU are the one signing off the work, not as a routine ack.`,

package/dist/{chunk-AXZGWR4M.js → chunk-IMSFAZWV.js}

@@ -1,15 +1,15 @@
 import {
   status
-} from "./chunk-XI7P3WSC.js";
+} from "./chunk-PDJOVOWH.js";
 import {
   uninstall
-} from "./chunk-GMYSDT2Y.js";
+} from "./chunk-UGB5UEYX.js";
 import {
   install
-} from "./chunk-F33EJZII.js";
+} from "./chunk-KQ3FJTHT.js";
 import {
   AgenticMailApiError
-} from "./chunk-UI556UPF.js";
+} from "./chunk-GVR4HTBB.js";
 
 // src/http-routes.ts
 import { Router } from "express";

package/dist/{chunk-F33EJZII.js → chunk-KQ3FJTHT.js}

@@ -14,7 +14,7 @@ import {
   resolveConfig,
   setAccountHost,
   setAccountRole
-} from "./chunk-UI556UPF.js";
+} from "./chunk-GVR4HTBB.js";
 
 // src/install.ts
 import { existsSync, mkdirSync, readdirSync, writeFileSync, readFileSync, unlinkSync } from "fs";

package/dist/{chunk-XI7P3WSC.js → chunk-PDJOVOWH.js}

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

package/dist/{chunk-VAEQFJDW.js → chunk-QSOMPN2D.js}

@@ -4,7 +4,7 @@ import {
   listPendingTasksForAgent,
   renderPersonaBody,
   resolveConfig
-} from "./chunk-UI556UPF.js";
+} from "./chunk-GVR4HTBB.js";
 
 // src/persona-loader.ts
 import { existsSync, readFileSync } from "fs";
@@ -285,6 +285,11 @@ function isContextOverflowError(msg) {
   const m = msg.toLowerCase();
   return m.includes("prompt is too long") || m.includes("context_length_exceeded") || m.includes("context length exceeded") || m.includes("max tokens") || m.includes("maximum context") || m.includes("token limit");
 }
+function isRateLimitError(msg) {
+  if (!msg) return false;
+  const m = msg.toLowerCase();
+  return m.includes("429") || m.includes("rate limit") || m.includes("rate-limit") || m.includes("rate_limit") || m.includes("too many requests") || m.includes("quota exceeded") || m.includes("quota_exceeded") || m.includes("usage limit") || m.includes("limit reached") || m.includes("overloaded_error") || m.includes("insufficient_quota") || m.includes("weekly limit") || m.includes("daily limit");
+}
 async function runWorker(query, persona, userPrompt, agent, mcpServerName, mcpCommand, mcpArgs, mcpEnv, log, abortSignal, observer, cwd) {
   const opts = {
     systemPrompt: persona,
@@ -535,7 +540,7 @@ function taskPrompt(agent, event) {
     `If you cannot complete the task, submit_result with { status: "failed", reason: "..." }. Never leave it unclaimed \u2014 that strands the caller until timeout.`
   ].join("\n");
 }
-var Dispatcher = class {
+var Dispatcher = class _Dispatcher {
   cfg;
   maxConcurrent;
   syncIntervalMs;
@@ -602,6 +607,15 @@ var Dispatcher = class {
    */
   wakeCoalesce = /* @__PURE__ */ new Map();
   wakeCoalesceMs;
+  /**
+   * In-memory queue of wakes the SDK rejected with a rate-limit
+   * error. See codex/dispatcher.ts for the full design rationale;
+   * the implementation is byte-for-byte identical here.
+   */
+  deferredRetries = /* @__PURE__ */ new Map();
+  static RATE_LIMIT_RETRY_MS = 60 * 60 * 1e3;
+  // 1 hour
+  static RATE_LIMIT_MAX_ATTEMPTS = 24;
   /** Wall-clock timestamp the dispatcher started. Surfaced via
    *  process-heartbeat so check_activity can show uptime. */
   startedAtMs = Date.now();
@@ -729,6 +743,13 @@ var Dispatcher = class {
     this.channels.clear();
     for (const entry of this.wakeCoalesce.values()) clearTimeout(entry.timer);
     this.wakeCoalesce.clear();
+    for (const entry of this.deferredRetries.values()) {
+      try {
+        clearTimeout(entry.timer);
+      } catch {
+      }
+    }
+    this.deferredRetries.clear();
     try {
       this.state.stop();
       this.state.flushNow();
@@ -1435,6 +1456,19 @@ var Dispatcher = class {
       const ok = workerResult?.ok === true;
       const preview = workerResult?.ok ? workerResult.text : workerResult ? workerResult.error : "worker did not start";
       writeLog(`worker_finished ok=${ok} chars=${preview.length}`);
+      if (workerResult && !workerResult.ok && isRateLimitError(workerResult.error)) {
+        this.scheduleRateLimitRetry(account, prompt, ctx, workerResult.error);
+      } else if (workerResult?.ok) {
+        const k = `${account.id}:${ctx.kind}:${ctx.uid ?? ctx.taskId ?? ""}`;
+        const existing = this.deferredRetries.get(k);
+        if (existing) {
+          try {
+            clearTimeout(existing.timer);
+          } catch {
+          }
+          this.deferredRetries.delete(k);
+        }
+      }
       try {
         logStream?.end();
       } catch {
@@ -1457,6 +1491,38 @@ var Dispatcher = class {
       });
     }
   }
+  /**
+   * Schedule a 1-hour retry for a wake that the SDK rejected with a
+   * rate-limit error. See the codex dispatcher's identical method
+   * for the full design rationale — same budget, same cadence,
+   * same in-memory-only state (catch-up scan handles restarts).
+   */
+  scheduleRateLimitRetry(account, prompt, ctx, errorMsg) {
+    const key = `${account.id}:${ctx.kind}:${ctx.uid ?? ctx.taskId ?? ""}`;
+    const existing = this.deferredRetries.get(key);
+    const attempts = (existing?.attempts ?? 0) + 1;
+    if (attempts > _Dispatcher.RATE_LIMIT_MAX_ATTEMPTS) {
+      this.log("warn", `[dispatcher] giving up on rate-limited retry for "${account.name}" (${ctx.kind}${ctx.uid ? " uid=" + ctx.uid : ""}) \u2014 exhausted ${attempts - 1} attempts over ~${((attempts - 1) * _Dispatcher.RATE_LIMIT_RETRY_MS / 36e5).toFixed(0)}h`);
+      this.deferredRetries.delete(key);
+      return;
+    }
+    if (existing) {
+      try {
+        clearTimeout(existing.timer);
+      } catch {
+      }
+    }
+    const retryAtMs = Date.now() + _Dispatcher.RATE_LIMIT_RETRY_MS;
+    const timer = setTimeout(() => {
+      this.deferredRetries.delete(key);
+      if (this.stopped) return;
+      this.log("info", `[dispatcher] retrying rate-limited wake for "${account.name}" (${ctx.kind}${ctx.uid ? " uid=" + ctx.uid : ""}) \u2014 attempt ${attempts}/${_Dispatcher.RATE_LIMIT_MAX_ATTEMPTS}`);
+      void this.spawnWorker(account, prompt, ctx);
+    }, _Dispatcher.RATE_LIMIT_RETRY_MS);
+    timer.unref?.();
+    this.deferredRetries.set(key, { timer, attempts });
+    this.log("warn", `[dispatcher] rate-limit hit for "${account.name}" (${ctx.kind}${ctx.uid ? " uid=" + ctx.uid : ""}) \u2014 retry scheduled for ${new Date(retryAtMs).toISOString()} (attempt ${attempts}/${_Dispatcher.RATE_LIMIT_MAX_ATTEMPTS}). SDK error: ${errorMsg.slice(0, 200)}`);
+  }
   /**
    * Fire-and-forget POST to the API's worker-activity endpoints.
    *

package/dist/{chunk-GMYSDT2Y.js → chunk-UGB5UEYX.js}

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

package/dist/cli.js

@@ -6,13 +6,13 @@ import {
 } from "./chunk-B5JDOV32.js";
 import {
   status
-} from "./chunk-XI7P3WSC.js";
+} from "./chunk-PDJOVOWH.js";
 import {
   uninstall
-} from "./chunk-GMYSDT2Y.js";
+} from "./chunk-UGB5UEYX.js";
 import {
   install
-} from "./chunk-F33EJZII.js";
+} from "./chunk-KQ3FJTHT.js";
 import "./chunk-LO5EQSQA.js";
 import "./chunk-US5FT2UB.js";
 import {
@@ -20,7 +20,7 @@ import {
   listAccounts,
   resolveConfig,
   setAccountHost
-} from "./chunk-UI556UPF.js";
+} from "./chunk-GVR4HTBB.js";
 
 // src/cli.ts
 var GREEN = (s) => `\x1B[32m${s}\x1B[0m`;

package/dist/dispatcher-bin.js

@@ -4,8 +4,8 @@ import {
 } from "./chunk-B5JDOV32.js";
 import {
   Dispatcher
-} from "./chunk-VAEQFJDW.js";
-import "./chunk-UI556UPF.js";
+} from "./chunk-QSOMPN2D.js";
+import "./chunk-GVR4HTBB.js";
 
 // src/dispatcher-bin.ts
 async function main() {

package/dist/dispatcher.d.ts

@@ -222,6 +222,14 @@ declare class Dispatcher {
      */
     private wakeCoalesce;
     private wakeCoalesceMs;
+    /**
+     * In-memory queue of wakes the SDK rejected with a rate-limit
+     * error. See codex/dispatcher.ts for the full design rationale;
+     * the implementation is byte-for-byte identical here.
+     */
+    private deferredRetries;
+    private static readonly RATE_LIMIT_RETRY_MS;
+    private static readonly RATE_LIMIT_MAX_ATTEMPTS;
     /** Wall-clock timestamp the dispatcher started. Surfaced via
      *  process-heartbeat so check_activity can show uptime. */
     private startedAtMs;
@@ -364,6 +372,13 @@ declare class Dispatcher {
     }, prompt: string): string;
     /** Acquire a concurrency slot, run a worker, release the slot. */
     private spawnWorker;
+    /**
+     * Schedule a 1-hour retry for a wake that the SDK rejected with a
+     * rate-limit error. See the codex dispatcher's identical method
+     * for the full design rationale — same budget, same cadence,
+     * same in-memory-only state (catch-up scan handles restarts).
+     */
+    private scheduleRateLimitRetry;
     /**
      * Fire-and-forget POST to the API's worker-activity endpoints.
      *

package/dist/dispatcher.js

@@ -1,7 +1,7 @@
 import {
   Dispatcher
-} from "./chunk-VAEQFJDW.js";
-import "./chunk-UI556UPF.js";
+} from "./chunk-QSOMPN2D.js";
+import "./chunk-GVR4HTBB.js";
 export {
   Dispatcher
 };

package/dist/http-routes.js

@@ -1,12 +1,12 @@
 import {
   createIntegrationRoutes
-} from "./chunk-AXZGWR4M.js";
-import "./chunk-XI7P3WSC.js";
-import "./chunk-GMYSDT2Y.js";
-import "./chunk-F33EJZII.js";
+} from "./chunk-IMSFAZWV.js";
+import "./chunk-PDJOVOWH.js";
+import "./chunk-UGB5UEYX.js";
+import "./chunk-KQ3FJTHT.js";
 import "./chunk-LO5EQSQA.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-UI556UPF.js";
+import "./chunk-GVR4HTBB.js";
 export {
   createIntegrationRoutes
 };

package/dist/index.js

@@ -6,19 +6,19 @@ import {
 import {
   Dispatcher,
   loadPersonaForAgent
-} from "./chunk-VAEQFJDW.js";
+} from "./chunk-QSOMPN2D.js";
 import {
   createIntegrationRoutes
-} from "./chunk-AXZGWR4M.js";
+} from "./chunk-IMSFAZWV.js";
 import {
   status
-} from "./chunk-XI7P3WSC.js";
+} from "./chunk-PDJOVOWH.js";
 import {
   uninstall
-} from "./chunk-GMYSDT2Y.js";
+} from "./chunk-UGB5UEYX.js";
 import {
   install
-} from "./chunk-F33EJZII.js";
+} from "./chunk-KQ3FJTHT.js";
 import "./chunk-LO5EQSQA.js";
 import "./chunk-US5FT2UB.js";
 import {
@@ -32,7 +32,7 @@ import {
   renderPersonaBody,
   renderSubagentMarkdown,
   resolveConfig
-} from "./chunk-UI556UPF.js";
+} from "./chunk-GVR4HTBB.js";
 export {
   AgenticMailApiError,
   Dispatcher,

package/dist/install.js

@@ -1,10 +1,10 @@
 import {
   install,
   selectExposableAgents
-} from "./chunk-F33EJZII.js";
+} from "./chunk-KQ3FJTHT.js";
 import "./chunk-LO5EQSQA.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-UI556UPF.js";
+import "./chunk-GVR4HTBB.js";
 export {
   install,
   selectExposableAgents

package/dist/status.js

@@ -1,8 +1,8 @@
 import {
   status
-} from "./chunk-XI7P3WSC.js";
+} from "./chunk-PDJOVOWH.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-UI556UPF.js";
+import "./chunk-GVR4HTBB.js";
 export {
   status
 };

package/dist/uninstall.js

@@ -1,9 +1,9 @@
 import {
   uninstall
-} from "./chunk-GMYSDT2Y.js";
+} from "./chunk-UGB5UEYX.js";
 import "./chunk-LO5EQSQA.js";
 import "./chunk-US5FT2UB.js";
-import "./chunk-UI556UPF.js";
+import "./chunk-GVR4HTBB.js";
 export {
   uninstall
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/claudecode",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "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",
@@ -47,7 +47,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@agenticmail/core": "^0.9.3",
+    "@agenticmail/core": "^0.9.4",
     "@agenticmail/mcp": "^0.9.4",
     "@anthropic-ai/claude-agent-sdk": "^0.2.140"
   },