@agenticmail/claudecode 0.1.16 → 0.1.17

package/README.md

@@ -16,7 +16,24 @@ 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.14
+## ✨ What's new in 0.1.17
+
+- **⏱ Compact-and-continue (0.1.17)** — workers can now run across multiple SDK turns when one isn't enough to finish a task. `runWorker` is wrapped by `runWorkerWithCompaction`, which on a context-overflow error (`prompt is too long`, `context_length_exceeded`, etc.) synthesises a breadcrumb checkpoint from the captured tool-call log + last assistant text, builds a continuation prompt prefixed with "Resuming after context reset / do NOT redo these steps", and loops. Capped at 4 iterations by default so cost is bounded; on cap exhaustion the worker exits with `compaction budget exhausted` so the host sees what happened.
+- **🪝 Mail-hook resolves with absolute path (0.1.16)** — the hook command registered in `~/.claude/settings.json` is now `node "<abs-path>/mail-hook.js"` instead of the bare bin name. `import.meta.url` + a 3-step filesystem probe (`dist/` sibling → `dist/` alongside `src/` → `../dist/`) handle both published builds and dev checkouts (`tsx`-loaded `src/install.ts` no longer points at a non-existent `src/mail-hook.js`). The `command not found` and `MODULE_NOT_FOUND` errors are gone. Existing installs auto-heal on the next `agenticmail claudecode` run because the upserter rewrites the command with the freshly-resolved path.
+- **📨 Stop hook output rewritten (0.1.15 / 0.1.16)** — the Stop hook's `reason` is printed to the user in the transcript. The original text was written assuming only the model would see it; phrases like "you do NOT need to ping the user" and "surface them to the user" read as awkward instruction-leakage. New shape:
+  ```
+  🎀 New AgenticMail (bridge inbox) — N messages since the last check:
+
+    · UID 2 — vesper · Re: Audit assignment…
+      > <up to 180 chars of preview body>
+
+  Full body: mcp__agenticmail__read_email. Reply: mcp__agenticmail__reply_email (replyAll: true).
+  ```
+  Same body for both UserPromptSubmit and Stop. Hard wall-time bound (1.5 s global timeout, 800 ms per fetch) and proper stdin listener cleanup so the hook never holds the harness REPL.
+- **🤖 Autonomous-mode awareness via Stop hook (0.1.14)** — the mail hook now registers on `Stop` in addition to `UserPromptSubmit`. Long headless Claude Code runs (no user prompts firing for hours) 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 which used the wrong output shape.
+- **📥 Long-running workers (0.1.14)** — dropped the 30-min hard timeout. Per-worker log file at `~/.agenticmail/worker-logs/<id>.log` capturing every SDK tool call / result / assistant chunk. 30 s heartbeats POSTed to the API so `check_activity` shows real progress. Per-worker scratch cwd at `~/.agenticmail/worker-cwds/<id>/` prevents parallel agents from clobbering each other's output. Tail via the MCP `tail_worker` tool.
+
+## ✨ Earlier — 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.

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

@@ -104,6 +104,64 @@ function threadIdFromSubject(subject) {
 }
 var DEFAULT_MAX_WAKES_PER_THREAD = 10;
 var DEFAULT_WAKE_WINDOW_MS = 24 * 60 * 60 * 1e3;
+async function runWorkerWithCompaction(query, persona, initialPrompt, agent, mcpServerName, mcpCommand, mcpArgs, mcpEnv, log, observer, cwd, maxIterations = 4) {
+  let prompt = initialPrompt;
+  let lastResult = null;
+  const breadcrumbs = [];
+  const captureObserver = {
+    onMessage(tag, summary) {
+      observer.onMessage(tag, summary);
+      if (tag === "tool_use") breadcrumbs.push(`\u2713 ${summary}`);
+      else if (tag === "tool_result") breadcrumbs.push(`  \u2192 ${summary}`);
+    }
+  };
+  for (let iter = 0; iter < maxIterations; iter++) {
+    if (iter > 0) {
+      log("info", `[dispatcher] compaction iter ${iter + 1}/${maxIterations} for "${agent.name}"`);
+    }
+    lastResult = await runWorker(
+      query,
+      persona,
+      prompt,
+      agent,
+      mcpServerName,
+      mcpCommand,
+      mcpArgs,
+      mcpEnv,
+      log,
+      void 0,
+      captureObserver,
+      cwd
+    );
+    if (lastResult.ok) return lastResult;
+    if (!isContextOverflowError(lastResult.error)) return lastResult;
+    if (iter === maxIterations - 1) {
+      return { ok: false, error: `compaction budget exhausted (${maxIterations} iters): ${lastResult.error}` };
+    }
+    const checkpoint = breadcrumbs.slice(-40).join("\n");
+    prompt = [
+      initialPrompt,
+      "",
+      "## Resuming after context reset",
+      "",
+      "You hit the model context limit on the previous turn. Here is a",
+      "breadcrumb of what you already accomplished in that turn \u2014",
+      "do NOT redo any of these steps:",
+      "",
+      checkpoint || "(no breadcrumbs captured)",
+      "",
+      "Continue from where you left off. If you have already produced",
+      "the final deliverable on the previous turn (e.g. submit_result,",
+      "reply_email), do nothing this turn and end cleanly."
+    ].join("\n");
+    log("info", `[dispatcher] context overflow on "${agent.name}" \u2014 compacting (${breadcrumbs.length} breadcrumbs)`);
+  }
+  return lastResult ?? { ok: false, error: "worker did not run" };
+}
+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");
+}
 async function runWorker(query, persona, userPrompt, agent, mcpServerName, mcpCommand, mcpArgs, mcpEnv, log, abortSignal, observer, cwd) {
   const opts = {
     systemPrompt: persona,
@@ -778,7 +836,7 @@ var Dispatcher = class {
       });
       this.log("info", `[dispatcher] waking "${account.name}" \u2014 ${ctx.kind}${ctx.taskId ? " " + ctx.taskId : ctx.uid ? " uid=" + ctx.uid : ""}`);
       const mcpEnv = await this.buildMcpEnv();
-      workerResult = await runWorker(
+      workerResult = await runWorkerWithCompaction(
         this.query,
         body,
         prompt,
@@ -788,7 +846,6 @@ var Dispatcher = class {
         this.cfg.mcpArgs,
         mcpEnv,
         this.log,
-        void 0,
         observer,
         cwdDir
       );

package/dist/dispatcher-bin.js

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

package/dist/dispatcher.js

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

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   Dispatcher,
   loadPersonaForAgent
-} from "./chunk-RNKJRBEF.js";
+} from "./chunk-SO75WFJB.js";
 import {
   createIntegrationRoutes
 } from "./chunk-PTLX7SQV.js";

package/package.json

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