@agenticmail/claudecode 0.2.18 → 0.2.19

package/dist/{chunk-O7S3FYJT.js → chunk-7FQNH2YO.js}

@@ -273,6 +273,35 @@ function renderPersonaBody(input) {
     "",
     `**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]\` PAIRED with \`wake: []\`. The marker tells the dispatcher to stop waking workers; the empty wake confirms you mean it. Use this when YOU are the one signing off the work, not as a routine ack. ANY OTHER use of \`wake: []\` is a bug.`,
     "",
+    `**Handing off to the host bridge (\`claudecode\` / \`codex\`) \u2014 read this carefully too.** The host bridge inboxes belong to the HUMAN OPERATOR's host session, not to an automated worker. The dispatcher DOES NOT spawn worker turns for them \u2014 they're surfaced to the operator via host-session hooks (Stop / UserPromptSubmit) when the operator's CLI is actively running. If no host session is open, mail to the bridge sits unread.`,
+    "",
+    `Practical implications:`,
+    `  \xB7 DO NOT use bridge handoffs as a default "punt the baton when you don't know what to do" move. The chain dies if the operator isn't watching.`,
+    `  \xB7 BEFORE handing off to the bridge, ask: is there a teammate (another sub-agent) who could decide this instead? If yes, route to them and CC the bridge as an FYI observer (do not name the bridge in \`wake\`).`,
+    `  \xB7 ONLY hand off to the bridge when you genuinely need the operator's judgment \u2014 billing-side rate limits, scope changes, architectural calls only the human can make, ambiguous spec questions where no sub-agent has authority. Treat it like paging a human at 2am: legitimate sometimes, rude often.`,
+    `  \xB7 WHEN you must escalate, mark the subject with \`[NEEDS OPERATOR]\` or \`[BLOCKED]\` so the operator's notification feed surfaces it. State the exact question + the options + your recommendation in the body. Don't make them re-read the thread.`,
+    `  \xB7 You can name the bridge in \`wake: ["claudecode"]\` / \`wake: ["codex"]\` to signal intent \u2014 the dispatcher still won't spawn a worker (bridges are filtered), but the web UI's notification sound + system event still fires so an attentive operator hears it.`,
+    "",
+    `Example \u2014 correct operator-escalation:`,
+    "",
+    "```",
+    `${tool("reply_email")}({ uid: 42, replyAll: true, _account: "${agent.name}",`,
+    `  subject: "[NEEDS OPERATOR] Slice 4 \u2014 Stripe vs Lemon Squeezy",`,
+    `  text: "Team: I've prototyped both. Stripe = better SDK, more compliance work. Lemon = faster ship, 5% take.\\nThis is a business call, not a code call. Operator \u2014 your pick?\\n\\nMy recommendation: Lemon for v0, swap later.",`,
+    `  wake: ["claudecode"] })  // signals intent; doesn't spawn a worker`,
+    "```",
+    "",
+    `Example \u2014 WRONG (this is how threads die):`,
+    "",
+    "```",
+    `// You finished your slice and don't know who's next. DO NOT do this:`,
+    `${tool("reply_email")}({ uid: 42, replyAll: true, _account: "${agent.name}",`,
+    `  text: "Shipped my slice. Claudecode \u2014 over to you for next steps.",`,
+    `  wake: ["claudecode"] })`,
+    `// Bridge sits unread until the operator notices.`,
+    `// Instead: bounce the baton to a teammate who can act, e.g. wake: ["vesper"].`,
+    "```",
+    "",
     `**When to use \`${tool("call_agent")}\` instead:** only when you need ONE structured answer from ONE teammate, inline in your current turn \u2014 e.g. "give me a JSON list of X". For multi-step / multi-agent work, the thread pattern above is the right primitive.`,
     "",
     `On-demand (via invoke) examples \u2014 anything NOT in the pre-loaded list:`,

package/dist/{chunk-OMUB5FRY.js → chunk-HCZTDR4T.js}

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

package/dist/{chunk-WC5ZK4RG.js → chunk-N6OG2X3V.js}

@@ -4,7 +4,7 @@ import {
   listPendingTasksForAgent,
   renderPersonaBody,
   resolveConfig
-} from "./chunk-O7S3FYJT.js";
+} from "./chunk-7FQNH2YO.js";
 
 // src/persona-loader.ts
 import { existsSync, readFileSync } from "fs";

package/dist/{chunk-4NKBITBR.js → chunk-NCV65VKS.js}

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

package/dist/{chunk-EWHWSNAQ.js → chunk-QXFCUEN3.js}

@@ -1,15 +1,15 @@
 import {
   status
-} from "./chunk-OMUB5FRY.js";
+} from "./chunk-HCZTDR4T.js";
 import {
   uninstall
-} from "./chunk-7D3D7T34.js";
+} from "./chunk-ZVIW6BL2.js";
 import {
   install
-} from "./chunk-4NKBITBR.js";
+} from "./chunk-NCV65VKS.js";
 import {
   AgenticMailApiError
-} from "./chunk-O7S3FYJT.js";
+} from "./chunk-7FQNH2YO.js";
 
 // src/http-routes.ts
 import { Router } from "express";

package/dist/{chunk-7D3D7T34.js → chunk-ZVIW6BL2.js}

@@ -10,7 +10,7 @@ import {
   deleteAccount,
   getAccountByName,
   resolveConfig
-} from "./chunk-O7S3FYJT.js";
+} from "./chunk-7FQNH2YO.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-OMUB5FRY.js";
+} from "./chunk-HCZTDR4T.js";
 import {
   uninstall
-} from "./chunk-7D3D7T34.js";
+} from "./chunk-ZVIW6BL2.js";
 import {
   install
-} from "./chunk-4NKBITBR.js";
+} from "./chunk-NCV65VKS.js";
 import "./chunk-SWDS64K2.js";
 import "./chunk-7DGWW72Q.js";
 import {
@@ -20,7 +20,7 @@ import {
   listAccounts,
   resolveConfig,
   setAccountHost
-} from "./chunk-O7S3FYJT.js";
+} from "./chunk-7FQNH2YO.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-WC5ZK4RG.js";
-import "./chunk-O7S3FYJT.js";
+} from "./chunk-N6OG2X3V.js";
+import "./chunk-7FQNH2YO.js";
 
 // src/dispatcher-bin.ts
 async function main() {

package/dist/dispatcher.js

@@ -1,7 +1,7 @@
 import {
   Dispatcher
-} from "./chunk-WC5ZK4RG.js";
-import "./chunk-O7S3FYJT.js";
+} from "./chunk-N6OG2X3V.js";
+import "./chunk-7FQNH2YO.js";
 export {
   Dispatcher
 };

package/dist/http-routes.js

@@ -1,12 +1,12 @@
 import {
   createIntegrationRoutes
-} from "./chunk-EWHWSNAQ.js";
-import "./chunk-OMUB5FRY.js";
-import "./chunk-7D3D7T34.js";
-import "./chunk-4NKBITBR.js";
+} from "./chunk-QXFCUEN3.js";
+import "./chunk-HCZTDR4T.js";
+import "./chunk-ZVIW6BL2.js";
+import "./chunk-NCV65VKS.js";
 import "./chunk-SWDS64K2.js";
 import "./chunk-7DGWW72Q.js";
-import "./chunk-O7S3FYJT.js";
+import "./chunk-7FQNH2YO.js";
 export {
   createIntegrationRoutes
 };

package/dist/index.js

@@ -6,19 +6,19 @@ import {
 import {
   Dispatcher,
   loadPersonaForAgent
-} from "./chunk-WC5ZK4RG.js";
+} from "./chunk-N6OG2X3V.js";
 import {
   createIntegrationRoutes
-} from "./chunk-EWHWSNAQ.js";
+} from "./chunk-QXFCUEN3.js";
 import {
   status
-} from "./chunk-OMUB5FRY.js";
+} from "./chunk-HCZTDR4T.js";
 import {
   uninstall
-} from "./chunk-7D3D7T34.js";
+} from "./chunk-ZVIW6BL2.js";
 import {
   install
-} from "./chunk-4NKBITBR.js";
+} from "./chunk-NCV65VKS.js";
 import "./chunk-SWDS64K2.js";
 import "./chunk-7DGWW72Q.js";
 import {
@@ -32,7 +32,7 @@ import {
   renderPersonaBody,
   renderSubagentMarkdown,
   resolveConfig
-} from "./chunk-O7S3FYJT.js";
+} from "./chunk-7FQNH2YO.js";
 export {
   AgenticMailApiError,
   Dispatcher,

package/dist/install.js

@@ -1,10 +1,10 @@
 import {
   install,
   selectExposableAgents
-} from "./chunk-4NKBITBR.js";
+} from "./chunk-NCV65VKS.js";
 import "./chunk-SWDS64K2.js";
 import "./chunk-7DGWW72Q.js";
-import "./chunk-O7S3FYJT.js";
+import "./chunk-7FQNH2YO.js";
 export {
   install,
   selectExposableAgents

package/dist/status.js

@@ -1,8 +1,8 @@
 import {
   status
-} from "./chunk-OMUB5FRY.js";
+} from "./chunk-HCZTDR4T.js";
 import "./chunk-7DGWW72Q.js";
-import "./chunk-O7S3FYJT.js";
+import "./chunk-7FQNH2YO.js";
 export {
   status
 };

package/dist/uninstall.js

@@ -1,9 +1,9 @@
 import {
   uninstall
-} from "./chunk-7D3D7T34.js";
+} from "./chunk-ZVIW6BL2.js";
 import "./chunk-SWDS64K2.js";
 import "./chunk-7DGWW72Q.js";
-import "./chunk-O7S3FYJT.js";
+import "./chunk-7FQNH2YO.js";
 export {
   uninstall
 };

package/package.json

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