@agenticmail/claudecode 0.1.12 → 0.1.14

package/README.md

@@ -16,7 +16,13 @@ Agent { subagent_type: "agenticmail-fola", prompt: "draft a reply to my last ema
 
 This package is to Claude Code what `@agenticmail/openclaw` is to OpenClaw: an integration package that wires AgenticMail into the host AI runtime. It mirrors that package's layout 1:1, so if you know one, you know the other.
 
-## ✨ What's new in 0.1.11
+## ✨ What's new in 0.1.14
+
+- **Workers run for hours** — dropped the 30-min hard timeout. Per-worker log file at `~/.agenticmail/worker-logs/<id>.log` capturing every SDK tool call + result + assistant chunk as a one-liner. Heartbeats POSTed to the API every 30 s so `check_activity` sees real progress. Per-worker scratch cwd at `~/.agenticmail/worker-cwds/<id>/` prevents parallel agents from clobbering each other's output. Tail via the new MCP tool `tail_worker`.
+- **Autonomous-mode awareness via Stop hook** — the mail hook now registers on the **Stop** Claude Code event too. Long headless runs (no user prompts) finally see teammate replies: when bridge mail is unread at a turn boundary, the hook returns `{decision: 'block', reason: '...'}`, forcing Claude to continue with the new-mail summary in context. This is the schema-correct supported way to inject context at Stop, unlike the 0.8.22 PreToolUse attempt.
+- **Hook bin resolved with absolute path** — previously the hook was registered as the bare bin name `agenticmail-mail-hook`, which produced `command not found` errors when the npm global bin dir wasn't on `$PATH`. Now resolved via `import.meta.url` at install time and registered as `node "/abs/.../mail-hook.js"`. Old bare-name installs auto-heal on the next `agenticmail claudecode` run.
+
+## ✨ Earlier — 0.1.11
 
 - **Selective wake** — when the sender sets `wake: ["alice", "bob"]` on `send_email` / `reply_email`, the dispatcher gives a Claude turn only to listed agents. CC'd-but-not-listed agents still receive the mail in their inbox but stay asleep. Single biggest token saver on multi-agent threads.
 - **Thread-close markers** — `[FINAL]`, `[DONE]`, `[CLOSED]`, `[WRAP]` in a subject. The dispatcher stops waking workers on any further reply to that thread. Closes the "no native done signal" gap from the 5-agent stress test.

package/dist/{chunk-6SCQVJBL.js → chunk-2GPBHK2M.js}

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

package/dist/{chunk-3ZIHOOA4.js → chunk-DKTAW2N5.js}

@@ -1,8 +1,12 @@
 // src/claude-hooks-config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync } from "fs";
 import { dirname } from "path";
-var AGENTICMAIL_HOOK_MARKER = "agenticmail-mail-hook";
-var HOOK_EVENTS = ["UserPromptSubmit", "PreToolUse"];
+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"];
 function readSettings(path) {
   if (!existsSync(path)) return {};
   const raw = readFileSync(path, "utf-8");
@@ -29,15 +33,30 @@ function upsertMailHook(path, command) {
   const settings = readSettings(path);
   if (!settings.hooks) settings.hooks = {};
   let changed = false;
-  for (const event of HOOK_EVENTS) {
+  for (const event of HOOK_EVENTS_TO_REGISTER) {
     if (upsertOneEvent(settings.hooks, event, command)) changed = true;
   }
+  for (const event of HOOK_EVENTS_TO_REMOVE) {
+    if (HOOK_EVENTS_TO_REGISTER.includes(event)) continue;
+    if (removeOneEvent(settings.hooks, event)) changed = true;
+  }
   if (changed) writeSettings(path, settings);
   return changed;
 }
+function removeOneEvent(hooks, event) {
+  const list = hooks[event] ?? [];
+  if (list.length === 0) return false;
+  const filtered = list.filter(
+    (rule) => !rule.hooks?.some((h) => isAgenticMailHookCommand(h.command))
+  );
+  if (filtered.length === list.length) return false;
+  if (filtered.length === 0) delete hooks[event];
+  else hooks[event] = filtered;
+  return true;
+}
 function upsertOneEvent(hooks, event, command) {
   const list = hooks[event] ?? [];
-  const isOurs = (rule) => rule.hooks?.some((h) => typeof h.command === "string" && h.command.includes(AGENTICMAIL_HOOK_MARKER)) ?? false;
+  const isOurs = (rule) => rule.hooks?.some((h) => isAgenticMailHookCommand(h.command)) ?? false;
   const desired = {
     matcher: "",
     // empty = match every fire of this event
@@ -61,19 +80,8 @@ function removeMailHook(path) {
   const settings = readSettings(path);
   if (!settings.hooks) return false;
   let changed = false;
-  for (const event of HOOK_EVENTS) {
-    const list = settings.hooks[event] ?? [];
-    if (list.length === 0) continue;
-    const filtered = list.filter(
-      (rule) => !rule.hooks?.some((h) => typeof h.command === "string" && h.command.includes(AGENTICMAIL_HOOK_MARKER))
-    );
-    if (filtered.length === list.length) continue;
-    if (filtered.length === 0) {
-      delete settings.hooks[event];
-    } else {
-      settings.hooks[event] = filtered;
-    }
-    changed = true;
+  for (const event of HOOK_EVENTS_TO_REMOVE) {
+    if (removeOneEvent(settings.hooks, event)) changed = true;
   }
   if (settings.hooks && Object.keys(settings.hooks).length === 0) {
     delete settings.hooks;

package/dist/{chunk-DI3DIMUQ.js → chunk-GAD64LKZ.js}

@@ -1,6 +1,6 @@
 import {
   upsertUserPromptSubmitHook
-} from "./chunk-3ZIHOOA4.js";
+} from "./chunk-DKTAW2N5.js";
 import {
   startDispatcher,
   upsertMcpServer
@@ -111,7 +111,7 @@ async function install(opts = {}) {
   const pruned = pruneStaleSubagentFiles(cfg.agentsDir, cfg, liveNames);
   let hookChanged = false;
   try {
-    hookChanged = upsertUserPromptSubmitHook(cfg.claudeSettingsPath, "agenticmail-mail-hook");
+    hookChanged = upsertUserPromptSubmitHook(cfg.claudeSettingsPath, resolveMailHookCommand());
   } catch {
   }
   const dispatcherStatus = await startDispatcherForInstall(cfg);
@@ -129,6 +129,12 @@ function resolveDispatcherBinPath() {
   const dir = thisFile.slice(0, thisFile.lastIndexOf("/"));
   return `${dir}/dispatcher-bin.js`;
 }
+function resolveMailHookCommand() {
+  const thisFile = fileURLToPath(import.meta.url);
+  const dir = thisFile.slice(0, thisFile.lastIndexOf("/"));
+  const hookPath = `${dir}/mail-hook.js`;
+  return `node "${hookPath}"`;
+}
 async function startDispatcherForInstall(cfg) {
   const binPath = resolveDispatcherBinPath();
   return startDispatcher({

package/dist/{chunk-5H46YKCX.js → chunk-RGLMLG7Y.js}

@@ -1,9 +1,9 @@
 import {
   uninstall
-} from "./chunk-6SCQVJBL.js";
+} from "./chunk-2GPBHK2M.js";
 import {
   install
-} from "./chunk-DI3DIMUQ.js";
+} from "./chunk-GAD64LKZ.js";
 import {
   status
 } from "./chunk-O4H76K3B.js";

package/dist/{chunk-YWUZKKQ5.js → chunk-RNKJRBEF.js}

@@ -36,6 +36,9 @@ function loadPersonaForAgent(opts) {
 }
 
 // src/dispatcher.ts
+import { mkdirSync, createWriteStream, rmSync } from "fs";
+import { join as join2 } from "path";
+import { homedir } from "os";
 function extractSubject(event) {
   if (typeof event.subject === "string") return event.subject;
   if (event.message && typeof event.message.subject === "string") return event.message.subject;
@@ -101,7 +104,7 @@ function threadIdFromSubject(subject) {
 }
 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) {
+async function runWorker(query, persona, userPrompt, agent, mcpServerName, mcpCommand, mcpArgs, mcpEnv, log, abortSignal, observer, cwd) {
   const opts = {
     systemPrompt: persona,
     mcpServers: {
@@ -133,6 +136,7 @@ async function runWorker(query, persona, userPrompt, agent, mcpServerName, mcpCo
     permissionMode: "bypassPermissions",
     abortController: abortSignal ? wrapSignal(abortSignal) : void 0
   };
+  if (cwd) opts.cwd = cwd;
   const collectedText = [];
   try {
     for await (const msg of query({ prompt: userPrompt, options: opts })) {
@@ -140,11 +144,32 @@ async function runWorker(query, persona, userPrompt, agent, mcpServerName, mcpCo
       if (m.type === "assistant" && Array.isArray(m.message && m.message.content)) {
         for (const block of m.message.content) {
           const b = block;
-          if (b.type === "text" && typeof b.text === "string") collectedText.push(b.text);
+          if (b.type === "text" && typeof b.text === "string") {
+            collectedText.push(b.text);
+            if (observer) observer.onMessage("assistant", b.text.slice(0, 240).replace(/\s+/g, " ").trim());
+          } else if (b.type === "tool_use" && typeof b.name === "string") {
+            const inputSummary = (() => {
+              try {
+                return JSON.stringify(b.input).slice(0, 200);
+              } catch {
+                return "(uninspectable input)";
+              }
+            })();
+            if (observer) observer.onMessage("tool_use", `${b.name} ${inputSummary}`);
+          }
+        }
+      } else if (m.type === "user" && Array.isArray(m.message && m.message.content)) {
+        for (const block of m.message.content) {
+          const b = block;
+          if (b.type === "tool_result") {
+            const bodyStr = typeof b.content === "string" ? b.content : Array.isArray(b.content) ? b.content.map((c) => c.text ?? "").join(" ") : "";
+            if (observer) observer.onMessage("tool_result", bodyStr.slice(0, 240).replace(/\s+/g, " ").trim());
+          }
         }
       }
       if (m.type === "result" && typeof m.result === "string") {
         collectedText.push(m.result);
+        if (observer) observer.onMessage("result", m.result.slice(0, 240).replace(/\s+/g, " ").trim());
       }
     }
     const text = collectedText.join("\n").trim();
@@ -153,6 +178,7 @@ async function runWorker(query, persona, userPrompt, agent, mcpServerName, mcpCo
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     log("error", `[dispatcher] worker for "${agent.name}" failed: ${msg}`);
+    if (observer) observer.onMessage("error", msg);
     return { ok: false, error: msg };
   }
 }
@@ -699,6 +725,50 @@ var Dispatcher = class {
       kind: ctx.kind,
       trigger: { uid: ctx.uid, taskId: ctx.taskId, subject: ctx.subject, from: ctx.from }
     });
+    const logsDir = join2(homedir(), ".agenticmail", "worker-logs");
+    try {
+      mkdirSync(logsDir, { recursive: true });
+    } catch {
+    }
+    const logPath = join2(logsDir, `${sanitizeId(workerId)}.log`);
+    let logStream = null;
+    try {
+      logStream = createWriteStream(logPath, { flags: "a" });
+    } catch {
+    }
+    const writeLog = (line) => {
+      try {
+        logStream?.write(`[${(/* @__PURE__ */ new Date()).toISOString()}] ${line}
+`);
+      } catch {
+      }
+    };
+    writeLog(`worker_started agent=${account.name} kind=${ctx.kind}${ctx.uid ? " uid=" + ctx.uid : ""}${ctx.taskId ? " task=" + ctx.taskId : ""}`);
+    const cwdDir = join2(homedir(), ".agenticmail", "worker-cwds", sanitizeId(workerId));
+    try {
+      mkdirSync(cwdDir, { recursive: true });
+    } catch {
+    }
+    let turnCount = 0;
+    let lastTool = "";
+    const observer = {
+      onMessage: (tag, summary) => {
+        writeLog(`${tag} ${summary}`);
+        if (tag === "tool_use") {
+          lastTool = summary.split(" ")[0];
+          turnCount++;
+        }
+      }
+    };
+    const heartbeatHandle = setInterval(() => {
+      this.postActivity("/dispatcher/worker-heartbeat", {
+        workerId,
+        agentName: account.name,
+        lastTool: lastTool || void 0,
+        turnCount
+      });
+    }, 3e4);
+    heartbeatHandle.unref?.();
     try {
       const { body } = loadPersonaForAgent({
         agent: account,
@@ -717,16 +787,30 @@ var Dispatcher = class {
         this.cfg.mcpCommand,
         this.cfg.mcpArgs,
         mcpEnv,
-        this.log
+        this.log,
+        void 0,
+        observer,
+        cwdDir
       );
     } finally {
+      clearInterval(heartbeatHandle);
       this.releaseSlot();
       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}`);
+      try {
+        logStream?.end();
+      } catch {
+      }
+      try {
+        rmSync(cwdDir, { recursive: true, force: true });
+      } catch {
+      }
       this.postActivity("/dispatcher/worker-finished", {
         workerId,
         agentName: account.name,
         ok,
+        turnCount,
         resultPreview: typeof preview === "string" ? preview.slice(0, 240) : void 0
       });
     }
@@ -789,6 +873,9 @@ var Dispatcher = class {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function sanitizeId(id) {
+  return id.replace(/[^a-zA-Z0-9._-]/g, "_");
+}
 function defaultLog(level, msg) {
   const stream = level === "error" ? process.stderr : process.stdout;
   stream.write(`[${(/* @__PURE__ */ new Date()).toISOString()}] [${level}] ${msg}

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   uninstall
-} from "./chunk-6SCQVJBL.js";
+} from "./chunk-2GPBHK2M.js";
 import {
   install
-} from "./chunk-DI3DIMUQ.js";
-import "./chunk-3ZIHOOA4.js";
+} from "./chunk-GAD64LKZ.js";
+import "./chunk-DKTAW2N5.js";
 import {
   status
 } from "./chunk-O4H76K3B.js";

package/dist/dispatcher-bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   Dispatcher
-} from "./chunk-YWUZKKQ5.js";
+} from "./chunk-RNKJRBEF.js";
 import "./chunk-SBP7MJP2.js";
 
 // src/dispatcher-bin.ts

package/dist/dispatcher.d.ts

@@ -110,6 +110,20 @@ interface QueryFn {
         options?: Record<string, unknown>;
     }): AsyncIterable<unknown>;
 }
+/**
+ * Per-worker observation channel. `runWorker` calls `onMessage` for every
+ * SDK message — assistant text, tool calls, tool results, result frames.
+ * The caller (spawnWorker) wires this to:
+ *   - a per-worker log file at `~/.agenticmail/worker-logs/<id>.log`
+ *   - a heartbeat ticker that POSTs progress to /dispatcher/worker-heartbeat
+ *
+ * Kept generic so tests don't need to mock disk + network to verify the
+ * observation path.
+ */
+interface WorkerObserver {
+    /** Called once per SDK message. Tag is a short event name. */
+    onMessage(tag: string, summary: string): void;
+}
 /**
  * The dispatcher itself. Construct once, call .start() to begin watching,
  * .stop() to tear down. Returns when stop() has finished cleaning up.
@@ -224,4 +238,4 @@ declare class Dispatcher {
     private releaseSlot;
 }
 
-export { Dispatcher, type DispatcherOptions, type QueryFn };
+export { Dispatcher, type DispatcherOptions, type QueryFn, type WorkerObserver };

package/dist/dispatcher.js

@@ -1,6 +1,6 @@
 import {
   Dispatcher
-} from "./chunk-YWUZKKQ5.js";
+} from "./chunk-RNKJRBEF.js";
 import "./chunk-SBP7MJP2.js";
 export {
   Dispatcher

package/dist/http-routes.js

@@ -1,9 +1,9 @@
 import {
   createIntegrationRoutes
-} from "./chunk-5H46YKCX.js";
-import "./chunk-6SCQVJBL.js";
-import "./chunk-DI3DIMUQ.js";
-import "./chunk-3ZIHOOA4.js";
+} from "./chunk-RGLMLG7Y.js";
+import "./chunk-2GPBHK2M.js";
+import "./chunk-GAD64LKZ.js";
+import "./chunk-DKTAW2N5.js";
 import "./chunk-O4H76K3B.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-SBP7MJP2.js";

package/dist/index.js

@@ -1,17 +1,17 @@
 import {
   Dispatcher,
   loadPersonaForAgent
-} from "./chunk-YWUZKKQ5.js";
+} from "./chunk-RNKJRBEF.js";
 import {
   createIntegrationRoutes
-} from "./chunk-5H46YKCX.js";
+} from "./chunk-RGLMLG7Y.js";
 import {
   uninstall
-} from "./chunk-6SCQVJBL.js";
+} from "./chunk-2GPBHK2M.js";
 import {
   install
-} from "./chunk-DI3DIMUQ.js";
-import "./chunk-3ZIHOOA4.js";
+} from "./chunk-GAD64LKZ.js";
+import "./chunk-DKTAW2N5.js";
 import {
   status
 } from "./chunk-O4H76K3B.js";

package/dist/install.js

@@ -1,8 +1,8 @@
 import {
   install,
   selectExposableAgents
-} from "./chunk-DI3DIMUQ.js";
-import "./chunk-3ZIHOOA4.js";
+} from "./chunk-GAD64LKZ.js";
+import "./chunk-DKTAW2N5.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-SBP7MJP2.js";
 export {

package/dist/mail-hook.js

@@ -9,7 +9,7 @@ var CONFIG_PATH = join(AGENTICMAIL_DIR, "config.json");
 var CURSOR_PATH = join(AGENTICMAIL_DIR, "claudecode-hook-cursor.json");
 var HOOK_VERSION = "1";
 var HTTP_TIMEOUT_MS = 2e3;
-var PRE_TOOL_USE_THROTTLE_MS = 3e4;
+var STOP_THROTTLE_MS = 15e3;
 async function readStdinJson() {
   if (process.stdin.isTTY) return null;
   return new Promise((resolve) => {
@@ -73,7 +73,7 @@ async function main() {
     }
   }
   const now = Date.now();
-  if (eventName === "PreToolUse" && now - lastCheckedMs < PRE_TOOL_USE_THROTTLE_MS) {
+  if (eventName === "Stop" && now - lastCheckedMs < STOP_THROTTLE_MS) {
     return;
   }
   let messages = [];
@@ -94,7 +94,7 @@ async function main() {
     return Number.isFinite(t) && t > cursorMs;
   });
   if (newOnes.length === 0) {
-    if (eventName === "PreToolUse") {
+    if (eventName === "Stop") {
       try {
         if (!existsSync(dirname(CURSOR_PATH))) mkdirSync(dirname(CURSOR_PATH), { recursive: true });
         writeFileSync(
@@ -135,12 +135,19 @@ async function main() {
     );
   } catch {
   }
-  process.stdout.write(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: eventName,
-      additionalContext: lines.join("\n")
-    }
-  }));
+  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")
+      }
+    }));
+  }
 }
 main().catch(() => {
   process.exit(0);

package/dist/uninstall.js

@@ -1,7 +1,7 @@
 import {
   uninstall
-} from "./chunk-6SCQVJBL.js";
-import "./chunk-3ZIHOOA4.js";
+} from "./chunk-2GPBHK2M.js";
+import "./chunk-DKTAW2N5.js";
 import "./chunk-US5FT2UB.js";
 import "./chunk-SBP7MJP2.js";
 export {

package/package.json

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