@agenticmail/claudecode 0.1.17 → 0.2.1

package/dist/dispatcher.d.ts

@@ -1,4 +1,4 @@
-import { R as ResolveConfigOptions, A as AgenticMailAccount } from './config-CjEDSvVy.js';
+import { R as ResolveConfigOptions, A as AgenticMailAccount } from './config-CXW3gXFC.js';
 
 /**
  * AgenticMail → Claude Code event dispatcher.
@@ -68,6 +68,11 @@ interface SSEEvent {
      * Claude turn. When absent, every CC'd recipient wakes (v0.8.x default).
      */
     wakeAllowlist?: string[];
+    /** Per-recipient "was I on the To field?" flag emitted by the
+     *  API in 0.9.1+. Pairs with the recipient's `wake_on_cc`
+     *  preference: when the agent registered with wake_on_cc:false
+     *  and `wasOnTo !== true`, the dispatcher drops the wake. */
+    wasOnTo?: boolean;
     [key: string]: unknown;
 }
 interface DispatcherOptions extends ResolveConfigOptions {
@@ -102,6 +107,18 @@ interface DispatcherOptions extends ResolveConfigOptions {
     log?: (level: 'info' | 'warn' | 'error', msg: string) => void;
     /** Override Date.now() — tests use this to advance the budget clock. */
     nowMs?: () => number;
+    /** Debounce window for wake-coalescing per (agent, thread).
+     *  Default 30 s — covers a typical "burst of back-to-back
+     *  replies in 5–15 s" pattern without making single replies
+     *  feel sluggish. Set to 0 to disable coalescing entirely
+     *  (one Claude turn per event, pre-0.9.0 behaviour). */
+    wakeCoalesceMs?: number;
+    /** Override the ThreadCache disk root. Tests use a tmpdir;
+     *  production runs against ~/.agenticmail/thread-cache/. */
+    threadCacheDir?: string;
+    /** Override the AgentMemoryStore disk root. Same rationale as
+     *  threadCacheDir — only tests should set this. */
+    agentMemoryDir?: string;
 }
 /** Minimal Claude Agent SDK query signature we use. */
 interface QueryFn {
@@ -152,6 +169,40 @@ declare class Dispatcher {
     private maxWakesPerThread;
     private wakeWindowMs;
     private now;
+    /**
+     * Layered wake-context system. ThreadCache holds the last K
+     * envelopes per thread (built passively on every SSE new-mail
+     * event, even when no agent wakes). AgentMemoryStore holds
+     * per-(agent, thread) markdown that workers write at end-of-
+     * wake via the save_thread_memory MCP tool. Both are read on
+     * worker spawn and injected into the wake prompt — see
+     * spawnWorker for the rendering.
+     */
+    private threadCache;
+    private agentMemory;
+    /**
+     * Coalesced wake queue. Keyed by `${accountId}::${threadId}`,
+     * each entry holds the pending events + the timer that will
+     * fire the spawn. A new event arriving while the entry exists
+     * EXTENDS the timer (debounce, not throttle) and appends to
+     * the event list. When the timer fires, a single Claude turn
+     * sees the union of new messages and replies once.
+     *
+     * Why debounce + not throttle: bursts of replies from one
+     * sender are typically a single logical handoff, not N
+     * separate actions. Throttling would still produce a stale
+     * wake after the burst settles; debouncing collapses the
+     * whole burst into one wake at the trailing edge.
+     */
+    private wakeCoalesce;
+    private wakeCoalesceMs;
+    /** Wall-clock timestamp the dispatcher started. Surfaced via
+     *  process-heartbeat so check_activity can show uptime. */
+    private startedAtMs;
+    /** Periodic timer that posts a process-heartbeat to the API.
+     *  Without this, a hung dispatcher looks identical to "no
+     *  events to wake on" — the host has no liveness signal. */
+    private processHeartbeatTimer;
     constructor(opts?: DispatcherOptions);
     /**
      * Charge one wake against the (agent, thread) budget. Returns true
@@ -221,6 +272,51 @@ declare class Dispatcher {
     private runChannel;
     /** Single SSE attach. Returns when the stream closes for any reason. */
     private streamOne;
+    /**
+     * Enqueue (or extend) a wake for `(account, thread)`. First
+     * event creates the entry + starts the debounce timer; every
+     * subsequent event within the window APPENDS to the event
+     * list and EXTENDS the timer to `now + wakeCoalesceMs`.
+     *
+     * When the timer fires, `fireCoalescedWake` synthesises a
+     * single wake prompt covering every event that arrived in
+     * the burst and spawns one worker. The wake-budget is
+     * charged ONCE for the batch (a burst of 4 replies is one
+     * logical handoff, not four).
+     *
+     * When `wakeCoalesceMs` is 0 (test mode / opt-out), we skip
+     * the queue and spawn immediately to keep the pre-0.9.0
+     * one-event-per-wake semantics.
+     */
+    private scheduleCoalescedWake;
+    /**
+     * Pre-0.9.0 fast path used when coalescing is disabled. Same
+     * spawn that scheduleCoalescedWake/fireCoalescedWake would do
+     * for a single-event batch.
+     */
+    private fireWakeImmediately;
+    /**
+     * Timer callback for the coalesced wake. Builds a single wake
+     * prompt that summarises every event in the batch and fires
+     * one worker. Wake budget is charged once for the batch.
+     */
+    private fireCoalescedWake;
+    /**
+     * Prepend the thread-context block (cache + memory) to the
+     * wake prompt for a given account. Returns the prompt
+     * unchanged when neither layer has content — the very first
+     * wake on a brand-new thread shouldn't show the agent an
+     * empty "Thread context" section that screams "you've seen
+     * this before" when there's nothing to see.
+     *
+     * Exposed as a separate method so tests can drive it
+     * directly without invoking the SDK.
+     */
+    composeWakePromptWithContext(account: AgenticMailAccount, ctx: {
+        kind: string;
+        subject?: string;
+        uid?: number;
+    }, prompt: string): string;
     /** Acquire a concurrency slot, run a worker, release the slot. */
     private spawnWorker;
     /**
@@ -232,6 +328,22 @@ declare class Dispatcher {
      * load-bearing state.
      */
     private postActivity;
+    /**
+     * Post a "skipped wake" notification with the reason the
+     * dispatcher decided not to fire a Claude turn. Surfaced in
+     * `check_activity` so the host can see the decision instead
+     * of just observing silence ("did my mail land? did the
+     * dispatcher skip it? is the dispatcher even alive?").
+     *
+     * Reasons cover every filter that drops a wake:
+     *   - thread-closed       — subject had [FINAL]/[DONE]/[CLOSED]/[WRAP]
+     *   - allowlist-excluded  — sender's `wake` list did not include the agent
+     *   - wake-on-cc          — agent registered wake_on_cc:false and was on Cc
+     *   - dedup               — duplicate UID seen recently
+     *   - rpc-suppress        — RPC-notification mail right after a task event
+     *   - budget-exhausted    — per-(agent, thread) wake budget hit the cap
+     */
+    private postSkipped;
     /** Build the env block we pass to the worker's MCP server child process. */
     private buildMcpEnv;
     private acquireSlot;

package/dist/dispatcher.js

@@ -1,7 +1,13 @@
 import {
   Dispatcher
-} from "./chunk-SO75WFJB.js";
+} from "./chunk-TWFORAWT.js";
+import "./chunk-DDJNA5HP.js";
+import "./chunk-B276KPVO.js";
+import "./chunk-RB5MGRT3.js";
+import "./chunk-XNNC4MIH.js";
+import "./chunk-BYXBJQAS.js";
 import "./chunk-SBP7MJP2.js";
+import "./chunk-2ESYSVXG.js";
 export {
   Dispatcher
 };

package/dist/email-worker-template-BOJPKCVB-3QPP3TCG.js

@@ -0,0 +1,40 @@
+import "./chunk-BYXBJQAS.js";
+import "./chunk-2ESYSVXG.js";
+
+// ../core/dist/email-worker-template-BOJPKCVB.js
+var EMAIL_WORKER_SCRIPT = `
+export default {
+  async email(message, env, ctx) {
+    // Read the raw RFC822 stream into an ArrayBuffer, then base64-encode
+    // because the inbound endpoint expects base64 in the rawEmail field.
+    const arrayBuf = await new Response(message.raw).arrayBuffer();
+    const bytes = new Uint8Array(arrayBuf);
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+      binary += String.fromCharCode(bytes[i]);
+    }
+    const rawEmail = btoa(binary);
+
+    const response = await fetch(env.INBOUND_URL, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-Inbound-Secret': env.INBOUND_SECRET,
+      },
+      body: JSON.stringify({
+        from: message.from,
+        to: message.to,
+        rawEmail,
+      }),
+    });
+
+    if (!response.ok) {
+      // Log but don't reject \u2014 rejecting causes bounce-back to sender
+      console.error('AgenticMail inbound webhook failed:', response.status, await response.text());
+    }
+  },
+};
+`;
+export {
+  EMAIL_WORKER_SCRIPT
+};

package/dist/http-routes.js

@@ -7,6 +7,7 @@ import "./chunk-DKTAW2N5.js";
 import "./chunk-O4H76K3B.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-SBP7MJP2.js";
+import "./chunk-2ESYSVXG.js";
 export {
   createIntegrationRoutes
 };

package/dist/imap-flow-DSPQFUHY.js

@@ -0,0 +1,6 @@
+import {
+  require_imap_flow
+} from "./chunk-DDJNA5HP.js";
+import "./chunk-RB5MGRT3.js";
+import "./chunk-2ESYSVXG.js";
+export default require_imap_flow();

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { install } from './install.js';
 export { UninstallOptions, uninstall } from './uninstall.js';
 export { status } from './status.js';
-import { A as AgenticMailAccount } from './config-CjEDSvVy.js';
-export { C as ClaudeCodeIntegrationConfig, I as InstallResult, a as InstallStatus, R as ResolveConfigOptions, U as UninstallResult, r as resolveConfig } from './config-CjEDSvVy.js';
+import { A as AgenticMailAccount } from './config-CXW3gXFC.js';
+export { C as ClaudeCodeIntegrationConfig, I as InstallResult, a as InstallStatus, R as ResolveConfigOptions, U as UninstallResult, r as resolveConfig } from './config-CXW3gXFC.js';
 export { createIntegrationRoutes } from './http-routes.js';
 export { Dispatcher, DispatcherOptions, QueryFn } from './dispatcher.js';
 import 'express';

package/dist/index.js

@@ -1,7 +1,12 @@
 import {
   Dispatcher,
   loadPersonaForAgent
-} from "./chunk-SO75WFJB.js";
+} from "./chunk-TWFORAWT.js";
+import "./chunk-DDJNA5HP.js";
+import "./chunk-B276KPVO.js";
+import "./chunk-RB5MGRT3.js";
+import "./chunk-XNNC4MIH.js";
+import "./chunk-BYXBJQAS.js";
 import {
   createIntegrationRoutes
 } from "./chunk-PTLX7SQV.js";
@@ -28,6 +33,7 @@ import {
   renderSubagentMarkdown,
   resolveConfig
 } from "./chunk-SBP7MJP2.js";
+import "./chunk-2ESYSVXG.js";
 export {
   AgenticMailApiError,
   Dispatcher,

package/dist/install.d.ts

@@ -1,4 +1,4 @@
-import { R as ResolveConfigOptions, I as InstallResult, A as AgenticMailAccount, C as ClaudeCodeIntegrationConfig } from './config-CjEDSvVy.js';
+import { R as ResolveConfigOptions, I as InstallResult, A as AgenticMailAccount, C as ClaudeCodeIntegrationConfig } from './config-CXW3gXFC.js';
 
 /**
  * Install AgenticMail into Claude Code.

package/dist/install.js

@@ -5,6 +5,7 @@ import {
 import "./chunk-DKTAW2N5.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-SBP7MJP2.js";
+import "./chunk-2ESYSVXG.js";
 export {
   install,
   selectExposableAgents

package/dist/mailparser-TAVZQM56.js

@@ -0,0 +1,6 @@
+import {
+  require_mailparser
+} from "./chunk-B276KPVO.js";
+import "./chunk-RB5MGRT3.js";
+import "./chunk-2ESYSVXG.js";
+export default require_mailparser();

package/dist/spam-filter-L6KNZ7QI-5RMBDUQG.js

@@ -0,0 +1,14 @@
+import {
+  SPAM_THRESHOLD,
+  WARNING_THRESHOLD,
+  isInternalEmail,
+  scoreEmail
+} from "./chunk-XNNC4MIH.js";
+import "./chunk-BYXBJQAS.js";
+import "./chunk-2ESYSVXG.js";
+export {
+  SPAM_THRESHOLD,
+  WARNING_THRESHOLD,
+  isInternalEmail,
+  scoreEmail
+};

package/dist/status.d.ts

@@ -1,4 +1,4 @@
-import { R as ResolveConfigOptions, a as InstallStatus } from './config-CjEDSvVy.js';
+import { R as ResolveConfigOptions, a as InstallStatus } from './config-CXW3gXFC.js';
 
 /**
  * Inspect the current install state of @agenticmail/claudecode.

package/dist/status.js

@@ -3,6 +3,7 @@ import {
 } from "./chunk-O4H76K3B.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-SBP7MJP2.js";
+import "./chunk-2ESYSVXG.js";
 export {
   status
 };

package/dist/uninstall.d.ts

@@ -1,4 +1,4 @@
-import { R as ResolveConfigOptions, U as UninstallResult } from './config-CjEDSvVy.js';
+import { R as ResolveConfigOptions, U as UninstallResult } from './config-CXW3gXFC.js';
 
 /**
  * Uninstall AgenticMail from Claude Code.

package/dist/uninstall.js

@@ -4,6 +4,7 @@ import {
 import "./chunk-DKTAW2N5.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-SBP7MJP2.js";
+import "./chunk-2ESYSVXG.js";
 export {
   uninstall
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/claudecode",
-  "version": "0.1.17",
+  "version": "0.2.1",
   "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/mcp": "^0.7.0",
+    "@agenticmail/mcp": "^0.9.1",
     "@anthropic-ai/claude-agent-sdk": "^0.2.140"
   },
   "peerDependencies": {