@agenticmail/claudecode 0.2.7 → 0.2.8

package/dist/{chunk-JUEHPFKY.js → chunk-2RVJ2Q3W.js}

@@ -1,6 +1,6 @@
 import {
   removeUserPromptSubmitHook
-} from "./chunk-DKTAW2N5.js";
+} from "./chunk-LO5EQSQA.js";
 import {
   removeMcpServer,
   stopDispatcher

package/dist/{chunk-DKTAW2N5.js → chunk-LO5EQSQA.js}

@@ -5,8 +5,8 @@ function isAgenticMailHookCommand(command) {
   if (typeof command !== "string") return false;
   return command.includes("agenticmail-mail-hook") || command.includes("mail-hook.js");
 }
-var HOOK_EVENTS_TO_REGISTER = ["UserPromptSubmit", "Stop"];
-var HOOK_EVENTS_TO_REMOVE = ["UserPromptSubmit", "Stop", "PreToolUse"];
+var HOOK_EVENTS_TO_REGISTER = ["UserPromptSubmit", "Stop", "SessionStart"];
+var HOOK_EVENTS_TO_REMOVE = ["UserPromptSubmit", "Stop", "PreToolUse", "SessionStart"];
 function readSettings(path) {
   if (!existsSync(path)) return {};
   const raw = readFileSync(path, "utf-8");

package/dist/{chunk-4EHV3I6W.js → chunk-OUYPF4ER.js}

@@ -1,6 +1,6 @@
 import {
   upsertUserPromptSubmitHook
-} from "./chunk-DKTAW2N5.js";
+} from "./chunk-LO5EQSQA.js";
 import {
   startDispatcher,
   upsertMcpServer

package/dist/{chunk-ZFLOFC6P.js → chunk-TV7VG7YM.js}

@@ -1,9 +1,9 @@
 import {
   uninstall
-} from "./chunk-JUEHPFKY.js";
+} from "./chunk-2RVJ2Q3W.js";
 import {
   install
-} from "./chunk-4EHV3I6W.js";
+} from "./chunk-OUYPF4ER.js";
 import {
   status
 } from "./chunk-Q5BA2J2C.js";

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   uninstall
-} from "./chunk-JUEHPFKY.js";
+} from "./chunk-2RVJ2Q3W.js";
 import {
   install
-} from "./chunk-4EHV3I6W.js";
-import "./chunk-DKTAW2N5.js";
+} from "./chunk-OUYPF4ER.js";
+import "./chunk-LO5EQSQA.js";
 import {
   status
 } from "./chunk-Q5BA2J2C.js";

package/dist/http-routes.js

@@ -1,9 +1,9 @@
 import {
   createIntegrationRoutes
-} from "./chunk-ZFLOFC6P.js";
-import "./chunk-JUEHPFKY.js";
-import "./chunk-4EHV3I6W.js";
-import "./chunk-DKTAW2N5.js";
+} from "./chunk-TV7VG7YM.js";
+import "./chunk-2RVJ2Q3W.js";
+import "./chunk-OUYPF4ER.js";
+import "./chunk-LO5EQSQA.js";
 import "./chunk-Q5BA2J2C.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-4VQP57SO.js";

package/dist/index.js

@@ -4,14 +4,14 @@ import {
 } from "./chunk-JOK76WRC.js";
 import {
   createIntegrationRoutes
-} from "./chunk-ZFLOFC6P.js";
+} from "./chunk-TV7VG7YM.js";
 import {
   uninstall
-} from "./chunk-JUEHPFKY.js";
+} from "./chunk-2RVJ2Q3W.js";
 import {
   install
-} from "./chunk-4EHV3I6W.js";
-import "./chunk-DKTAW2N5.js";
+} from "./chunk-OUYPF4ER.js";
+import "./chunk-LO5EQSQA.js";
 import {
   status
 } from "./chunk-Q5BA2J2C.js";

package/dist/install.js

@@ -1,8 +1,8 @@
 import {
   install,
   selectExposableAgents
-} from "./chunk-4EHV3I6W.js";
-import "./chunk-DKTAW2N5.js";
+} from "./chunk-OUYPF4ER.js";
+import "./chunk-LO5EQSQA.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-4VQP57SO.js";
 export {

package/dist/mail-hook.js

@@ -7,6 +7,8 @@ import { join, dirname } from "path";
 var AGENTICMAIL_DIR = join(homedir(), ".agenticmail");
 var CONFIG_PATH = join(AGENTICMAIL_DIR, "config.json");
 var CURSOR_PATH = join(AGENTICMAIL_DIR, "claudecode-hook-cursor.json");
+var SESSIONS_PATH = join(AGENTICMAIL_DIR, "claudecode-hook-sessions.json");
+var SESSIONS_CAP = 100;
 var HOOK_VERSION = "1";
 var HTTP_TIMEOUT_MS = 800;
 var GLOBAL_TIMEOUT_MS = 1500;
@@ -47,17 +49,95 @@ async function readStdinJson() {
     setTimeout(() => finish(() => null), 200).unref();
   });
 }
+function capabilitiesBlurb() {
+  return [
+    "\u{1F380} AgenticMail is available via MCP (mcp__agenticmail__*).",
+    "",
+    "When to reach for it:",
+    "  \xB7 Building anything that benefits from MULTIPLE specialized roles working in parallel \u2014 designer + developer + reviewer, researcher + writer + fact-checker, planner + executor + critic.",
+    "  \xB7 Coordinating long-running async work that survives across Claude Code restarts (email threads are durable; in-memory state is not).",
+    "  \xB7 Anywhere you would otherwise spawn the Task tool repeatedly for sub-tasks \u2014 prefer AgenticMail when those sub-tasks need to talk to EACH OTHER, not just back to you.",
+    "",
+    "High-leverage tools:",
+    "  \xB7 mcp__agenticmail__create_account({ name, role })       \u2014 spawn a fresh persistent agent identity with its own inbox + API key.",
+    '  \xB7 mcp__agenticmail__send_email({ to, cc, subject, text, wake }) \u2014 kick off the work. CC the whole team; use `wake: ["alice"]` to give exactly one agent the next turn while others stay informed.',
+    "  \xB7 mcp__agenticmail__call_agent({ agent, message }) / mcp__agenticmail__wait_for_email \u2014 blocking RPC when you need a specific answer back before continuing your own turn.",
+    "",
+    "Coordination pattern: one email thread = the shared workspace. Reply-all keeps the audit trail. Use `wake` to control whose turn it is.",
+    "",
+    "Other tools cover: inbox/folder management, drafts, templates, tasks, contacts, signatures, SMS, voice. Full list under mcp__agenticmail__* \u2014 discover on demand, don't front-load them all."
+  ].join("\n");
+}
+function loadSeenSessions() {
+  if (!existsSync(SESSIONS_PATH)) return [];
+  try {
+    const parsed = JSON.parse(readFileSync(SESSIONS_PATH, "utf-8"));
+    const arr = Array.isArray(parsed?.seen) ? parsed.seen : [];
+    return arr.filter((s) => typeof s === "string");
+  } catch {
+    return [];
+  }
+}
+function rememberSession(sessionId, seen) {
+  const next = seen.filter((s) => s !== sessionId);
+  next.push(sessionId);
+  while (next.length > SESSIONS_CAP) next.shift();
+  try {
+    if (!existsSync(dirname(SESSIONS_PATH))) mkdirSync(dirname(SESSIONS_PATH), { recursive: true });
+    writeFileSync(SESSIONS_PATH, JSON.stringify({ seen: next, hookVersion: HOOK_VERSION }, null, 2));
+  } catch {
+  }
+}
 async function main() {
   const input = await readStdinJson();
   const eventName = input?.hook_event_name ?? "UserPromptSubmit";
-  if (!existsSync(CONFIG_PATH)) return;
+  const sessionId = typeof input?.session_id === "string" ? input.session_id : "";
+  if (eventName === "SessionStart") {
+    process.stdout.write(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "SessionStart",
+        additionalContext: capabilitiesBlurb()
+      }
+    }));
+    return;
+  }
+  let blurbContext = "";
+  if (eventName === "UserPromptSubmit" && sessionId) {
+    const seen = loadSeenSessions();
+    if (!seen.includes(sessionId)) {
+      blurbContext = capabilitiesBlurb();
+      rememberSession(sessionId, seen);
+    }
+  }
+  const emitAndExit = (mailContext) => {
+    const combined = [blurbContext, mailContext].filter(Boolean).join("\n\n");
+    if (!combined) return;
+    if (eventName === "Stop") {
+      process.stdout.write(JSON.stringify({ decision: "block", reason: combined }));
+    } else {
+      process.stdout.write(JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: eventName,
+          additionalContext: combined
+        }
+      }));
+    }
+  };
+  if (!existsSync(CONFIG_PATH)) {
+    emitAndExit("");
+    return;
+  }
   let cfg;
   try {
     cfg = JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
   } catch {
+    emitAndExit("");
+    return;
+  }
+  if (!cfg.masterKey) {
+    emitAndExit("");
     return;
   }
-  if (!cfg.masterKey) return;
   const apiHost = cfg.api?.host ?? "127.0.0.1";
   const apiPort = cfg.api?.port ?? 3829;
   const apiUrl = `http://${apiHost}:${apiPort}`;
@@ -67,15 +147,22 @@ async function main() {
       headers: { Authorization: `Bearer ${cfg.masterKey}` },
       signal: AbortSignal.timeout(HTTP_TIMEOUT_MS)
     });
-    if (!r.ok) return;
+    if (!r.ok) {
+      emitAndExit("");
+      return;
+    }
     const data = await r.json();
     bridge = (data.agents ?? []).find(
       (a) => a.name === "claudecode" || a.name === "claude" || a.role === "bridge"
     );
   } catch {
+    emitAndExit("");
+    return;
+  }
+  if (!bridge?.apiKey) {
+    emitAndExit("");
     return;
   }
-  if (!bridge?.apiKey) return;
   let cursorMs = 0;
   let lastCheckedMs = 0;
   if (existsSync(CURSOR_PATH)) {
@@ -96,10 +183,14 @@ async function main() {
       headers: { Authorization: `Bearer ${bridge.apiKey}` },
       signal: AbortSignal.timeout(HTTP_TIMEOUT_MS)
     });
-    if (!r.ok) return;
+    if (!r.ok) {
+      emitAndExit("");
+      return;
+    }
     const data = await r.json();
     messages = data.messages ?? [];
   } catch {
+    emitAndExit("");
     return;
   }
   const newOnes = messages.filter((m) => {
@@ -118,6 +209,7 @@ async function main() {
       } catch {
       }
     }
+    emitAndExit("");
     return;
   }
   newOnes.sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime());
@@ -149,19 +241,7 @@ async function main() {
     );
   } catch {
   }
-  if (eventName === "Stop") {
-    process.stdout.write(JSON.stringify({
-      decision: "block",
-      reason: lines.join("\n")
-    }));
-  } else {
-    process.stdout.write(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: eventName,
-        additionalContext: lines.join("\n")
-      }
-    }));
-  }
+  emitAndExit(lines.join("\n"));
 }
 var globalTimeout = new Promise((resolve) => {
   setTimeout(() => resolve(), GLOBAL_TIMEOUT_MS).unref();

package/dist/uninstall.js

@@ -1,7 +1,7 @@
 import {
   uninstall
-} from "./chunk-JUEHPFKY.js";
-import "./chunk-DKTAW2N5.js";
+} from "./chunk-2RVJ2Q3W.js";
+import "./chunk-LO5EQSQA.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-4VQP57SO.js";
 export {

package/package.json

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