@desplega.ai/agent-swarm 1.148.0 → 1.149.0

package/README.md

@@ -5,7 +5,7 @@
 > **This repo evolves every single day.** [Watch now →](https://github.com/desplega-ai/agent-swarm/subscription)
 <p align="center"><video src="https://github.com/user-attachments/assets/e220712e-c54d-4f46-b059-bac04639d229" controls muted playsinline width="720"></video></p>
 <p align="center"><sub>▸ <a href="./assets/agent-swarm.mp4">daily evolution</a> · <a href="./assets/agent-swarm-slack-to-pr.mp4">slack → pr</a> · <a href="./assets/video-source">Making of</a></sub></p>
-<p align="center"><a href="https://agent-swarm.dev"><img src="https://img.shields.io/badge/Website-agent--swarm.dev-000?style=for-the-badge" alt="Website"></a> <a href="https://docs.agent-swarm.dev"><img src="https://img.shields.io/badge/Docs-docs.agent--swarm.dev-amber?style=for-the-badge" alt="Docs"></a> <a href="https://app.agent-swarm.dev"><img src="https://img.shields.io/badge/Dashboard-app.agent--swarm.dev-blue?style=for-the-badge" alt="Dashboard"></a> <a href="https://discord.gg/KZgfyyDVZa"><img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join Discord"></a> <a href="https://x.com/desplegalabs"><img src="https://img.shields.io/badge/𝕏-@desplegalabs-000?style=for-the-badge&logo=x&logoColor=white" alt="Follow on X"></a> <a href="https://www.linkedin.com/company/desplega-labs/"><img src="https://img.shields.io/badge/LinkedIn-Desplega%20Labs-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white" alt="Desplega Labs on LinkedIn"></a></p>
+<p align="center"><a href="https://agent-swarm.dev"><img src="https://img.shields.io/badge/Website-agent--swarm.dev-000?style=for-the-badge" alt="Website"></a> <a href="https://docs.agent-swarm.dev"><img src="https://img.shields.io/badge/Docs-docs.agent--swarm.dev-amber?style=for-the-badge" alt="Docs"></a> <a href="https://app.agent-swarm.dev"><img src="https://img.shields.io/badge/Dashboard-app.agent--swarm.dev-blue?style=for-the-badge" alt="Dashboard"></a> <a href="https://discord.gg/KZgfyyDVZa"><img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join Discord"></a> <a href="https://x.com/desplegalabs"><img src="https://img.shields.io/badge/𝕏-@desplegalabs-000?style=for-the-badge&logo=x&logoColor=white" alt="Follow on X"></a> <a href="https://www.linkedin.com/company/desplega-labs/"><img src="https://img.shields.io/badge/LinkedIn-Desplega%20Labs-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white" alt="Desplega Labs on LinkedIn"></a> <a href="https://www.youtube.com/@desplega-labs/videos"><img src="https://img.shields.io/badge/YouTube-Desplega%20Labs-FF0000?style=for-the-badge&logo=youtube&logoColor=white" alt="Desplega Labs on YouTube"></a></p>
 
 agent-swarm.dev is an open-source operating system for AI work. A lead agent delegates goals to workers such as Claude Code or Codex. Isolated containers, shared memory, tools, schedules, and review gates preserve work across sessions.
 
@@ -13,6 +13,7 @@ agent-swarm.dev is an open-source operating system for AI work. A lead agent del
 
 - A lead agent that receives work from Slack, repositories, issue trackers, email, or the API
 - [Schema-validated task results](./MCP.md#send-task) for callers that need structured JSON output
+- [Deferred tasks](./MCP.md#defer-task) that wake when another task finishes or a deadline arrives
 - [Dashboard file attachments](https://docs.agent-swarm.dev/docs/ui#file-attachments) by drag-and-drop or file picker
 - Workers in isolated Docker containers with development environments
 - Memory and identity that persist across sessions

package/dist/{acp-adapter-grez7xhd.js → acp-adapter-4jncb126.js}

@@ -29,11 +29,11 @@ import {
 import {
   init_package,
   package_default
-} from "./cli-anedxf1w.js";
+} from "./cli-kjwt6hdf.js";
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import"./cli-bc05qbss.js";
 
 // node_modules/@agentclientprotocol/sdk/dist/schema/index.js
@@ -4349,6 +4349,8 @@ class ClientSideConnection {
 init_package();
 
 // src/utils/acp-session-token.ts
+init_secret_scrubber();
+var REVOKE_TIMEOUT_MS = 5000;
 var ACP_SESSION_TOKEN_TTL_MS = 24 * 60 * 60 * 1000;
 async function mintAcpSessionToken(apiUrl, apiKey, agentId, taskId) {
   const res = await fetch(`${apiUrl.replace(/\/+$/, "")}/api/sessions/tokens`, {
@@ -4367,11 +4369,16 @@ async function mintAcpSessionToken(apiUrl, apiKey, agentId, taskId) {
 }
 async function revokeAcpSessionToken(apiUrl, apiKey, tokenId) {
   try {
-    await fetch(`${apiUrl.replace(/\/+$/, "")}/api/sessions/tokens/${tokenId}`, {
+    const res = await fetch(`${apiUrl.replace(/\/+$/, "")}/api/sessions/tokens/${tokenId}`, {
       method: "DELETE",
-      headers: { Authorization: `Bearer ${apiKey}` }
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(REVOKE_TIMEOUT_MS)
     });
-  } catch {}
+    if (!res.ok)
+      throw new Error(`HTTP ${res.status}`);
+  } catch (error) {
+    console.warn(scrubSecrets(`[acp] Session token revoke failed: ${error instanceof Error ? error.message : String(error)}`));
+  }
 }
 
 // src/providers/acp-adapter.ts

package/dist/{actions-kweznh5a.js → actions-31vp3ae7.js}

@@ -1,10 +1,10 @@
 import {
   resolveSlackUserId
-} from "./cli-n2cwscdd.js";
-import"./cli-xqcpg1st.js";
+} from "./cli-ykxrnd1q.js";
+import"./cli-gv88e1vf.js";
 import {
   createTaskWithSiblingAwareness
-} from "./cli-7gn7c2af.js";
+} from "./cli-q50ef8g0.js";
 import {
   buildCancelledBlocks,
   ensureSlackThreadTree,
@@ -12,7 +12,7 @@ import {
   getAgentEmoji,
   getTaskLink,
   isSlackRenderV2Enabled
-} from "./cli-dk3me3qs.js";
+} from "./cli-d8ftsp62.js";
 import"./cli-q51yprfq.js";
 import"./cli-9d8ntetj.js";
 import"./cli-yatxqynm.js";
@@ -24,16 +24,16 @@ import {
   init_context_key,
   init_db,
   slackContextKey
-} from "./cli-6s2y152y.js";
-import"./cli-y6b6fb76.js";
-import"./cli-kpv03zhj.js";
+} from "./cli-yab68w40.js";
+import"./cli-08b07b4r.js";
+import"./cli-3apbzgyk.js";
 import"./cli-e29gmdmw.js";
 import"./cli-c2mk1kgf.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-anedxf1w.js";
-import"./cli-xqcq9y5e.js";
+import"./cli-kjwt6hdf.js";
+import"./cli-r2ap2czm.js";
 import"./cli-pzxba7gw.js";
 import"./cli-zf8jjwex.js";
 import"./cli-bd957dgb.js";
@@ -104,6 +104,7 @@ function registerActionHandlers(app) {
     });
     const followUpTask = await createTaskWithSiblingAwareness(followUpText, {
       agentId: lead?.id,
+      routingReason: lead ? "skill" : undefined,
       source: "slack",
       parentTaskId: taskId,
       slackChannelId: originalTask.slackChannelId,

package/dist/{app-5fvvjv9m.js → app-1hh67x8w.js}

@@ -3,20 +3,20 @@ import {
   initSlackApp,
   startSlackApp,
   stopSlackApp
-} from "./cli-dk3me3qs.js";
+} from "./cli-d8ftsp62.js";
 import"./cli-q51yprfq.js";
 import"./cli-9d8ntetj.js";
 import"./cli-yatxqynm.js";
-import"./cli-6s2y152y.js";
-import"./cli-y6b6fb76.js";
-import"./cli-kpv03zhj.js";
+import"./cli-yab68w40.js";
+import"./cli-08b07b4r.js";
+import"./cli-3apbzgyk.js";
 import"./cli-e29gmdmw.js";
 import"./cli-c2mk1kgf.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-anedxf1w.js";
-import"./cli-xqcq9y5e.js";
+import"./cli-kjwt6hdf.js";
+import"./cli-r2ap2czm.js";
 import"./cli-pzxba7gw.js";
 import"./cli-zf8jjwex.js";
 import"./cli-bd957dgb.js";

package/dist/{assistant-40m4w50s.js → assistant-z66dmz6p.js}

@@ -2,7 +2,7 @@ import {
   bufferThreadMessage,
   getBufferMessageCount,
   wasEventSeen
-} from "./cli-qy6h009w.js";
+} from "./cli-qaacms9y.js";
 import {
   bufferedFileFailures,
   buildEffectiveText,
@@ -10,20 +10,20 @@ import {
   fetchSlackFiles,
   hasOtherUserMention,
   notifySlackFileFailures
-} from "./cli-hz8xhefy.js";
+} from "./cli-kgz4np97.js";
 import"./cli-jsp14b6c.js";
 import {
   resolveSlackUserId,
   rewriteSlackMentions
-} from "./cli-n2cwscdd.js";
-import"./cli-xqcpg1st.js";
-import"./cli-7gn7c2af.js";
+} from "./cli-ykxrnd1q.js";
+import"./cli-gv88e1vf.js";
+import"./cli-q50ef8g0.js";
 import {
   ackSlackMessage,
   ensureSlackThreadTree,
   isSlackRenderV2Enabled,
   require_dist
-} from "./cli-dk3me3qs.js";
+} from "./cli-d8ftsp62.js";
 import"./cli-q51yprfq.js";
 import"./cli-9d8ntetj.js";
 import"./cli-yatxqynm.js";
@@ -35,12 +35,12 @@ import {
   init_db,
   reactionName,
   slackContextKey
-} from "./cli-6s2y152y.js";
-import"./cli-y6b6fb76.js";
+} from "./cli-yab68w40.js";
+import"./cli-08b07b4r.js";
 import {
   init_resolver,
   resolveTemplate
-} from "./cli-kpv03zhj.js";
+} from "./cli-3apbzgyk.js";
 import"./cli-e29gmdmw.js";
 import"./cli-c2mk1kgf.js";
 import {
@@ -49,8 +49,8 @@ import {
 } from "./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-anedxf1w.js";
-import"./cli-xqcq9y5e.js";
+import"./cli-kjwt6hdf.js";
+import"./cli-r2ap2czm.js";
 import"./cli-pzxba7gw.js";
 import"./cli-zf8jjwex.js";
 import"./cli-bd957dgb.js";
@@ -159,6 +159,7 @@ function createAssistant() {
             const latestTask = await getMostRecentTaskInThread(channelId, threadTs);
             const { task: task2, unattached: unattached2 } = await createSlackTaskWithFiles(renderedMessageText, {
               agentId: workingAgent.id,
+              routingReason: "continuity",
               source: "slack",
               slackChannelId: channelId,
               slackThreadTs: threadTs,
@@ -207,6 +208,7 @@ function createAssistant() {
           }
           const { task, unattached } = await createSlackTaskWithFiles(renderedMessageText + channelContext, {
             agentId: lead.id,
+            routingReason: "skill",
             source: "slack",
             slackChannelId: channelId,
             slackThreadTs: threadTs,

package/dist/{boot-reembed-cn357y5n.js → boot-reembed-fqzxxzjh.js}

@@ -3,23 +3,23 @@ import {
   getEmbeddingProvider,
   getMemoryStore,
   init_constants
-} from "./cli-5khqvvnq.js";
-import"./cli-m9sxbkhm.js";
+} from "./cli-3q5ejx9p.js";
+import"./cli-zvz62chv.js";
 import"./cli-aehm1rbq.js";
 import"./cli-9d8ntetj.js";
 import {
   getDbClient,
   init_db
-} from "./cli-6s2y152y.js";
-import"./cli-y6b6fb76.js";
-import"./cli-kpv03zhj.js";
+} from "./cli-yab68w40.js";
+import"./cli-08b07b4r.js";
+import"./cli-3apbzgyk.js";
 import"./cli-e29gmdmw.js";
 import"./cli-c2mk1kgf.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-anedxf1w.js";
-import"./cli-xqcq9y5e.js";
+import"./cli-kjwt6hdf.js";
+import"./cli-r2ap2czm.js";
 import"./cli-zf8jjwex.js";
 import"./cli-bc05qbss.js";
 

package/dist/{boot-reembed-9rxmb26n.js → boot-reembed-wxa8ya0s.js}

@@ -1,24 +1,24 @@
 import {
   embedScript,
   embeddingProvider
-} from "./cli-kzvhgvk3.js";
-import"./cli-5khqvvnq.js";
-import"./cli-m9sxbkhm.js";
+} from "./cli-2qts1hys.js";
+import"./cli-3q5ejx9p.js";
+import"./cli-zvz62chv.js";
 import"./cli-aehm1rbq.js";
 import"./cli-9d8ntetj.js";
 import {
   getDbClient,
   init_db
-} from "./cli-6s2y152y.js";
-import"./cli-y6b6fb76.js";
-import"./cli-kpv03zhj.js";
+} from "./cli-yab68w40.js";
+import"./cli-08b07b4r.js";
+import"./cli-3apbzgyk.js";
 import"./cli-e29gmdmw.js";
 import"./cli-c2mk1kgf.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-anedxf1w.js";
-import"./cli-xqcq9y5e.js";
+import"./cli-kjwt6hdf.js";
+import"./cli-r2ap2czm.js";
 import"./cli-zf8jjwex.js";
 import"./cli-bc05qbss.js";
 

package/dist/{boot-scrub-logs-5tpp0x3y.js → boot-scrub-logs-jnyndh79.js}

@@ -1,19 +1,19 @@
 import {
   getDbClient,
   init_db
-} from "./cli-6s2y152y.js";
-import"./cli-y6b6fb76.js";
-import"./cli-kpv03zhj.js";
+} from "./cli-yab68w40.js";
+import"./cli-08b07b4r.js";
+import"./cli-3apbzgyk.js";
 import"./cli-e29gmdmw.js";
 import"./cli-c2mk1kgf.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-anedxf1w.js";
+import"./cli-kjwt6hdf.js";
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import"./cli-zf8jjwex.js";
 import"./cli-bc05qbss.js";
 

package/dist/{claude-adapter-9pz5q2pb.js → claude-adapter-3qpa9w0j.js}

@@ -17,11 +17,11 @@ import {
   resolveClaudeBridgeEnabled,
   resolveClaudeQueueSteeringOverride,
   runClaudeSessionSummary
-} from "./cli-m1p5cysp.js";
-import"./cli-brxyat7h.js";
-import"./cli-d8brzxjb.js";
+} from "./cli-7smrsr25.js";
+import"./cli-cr12paw2.js";
+import"./cli-4wtq5jjv.js";
 import"./cli-b5b30yzk.js";
-import"./cli-rvqz34y5.js";
+import"./cli-jecc01cb.js";
 import"./cli-hp1n6zq3.js";
 import"./cli-tng3131n.js";
 import"./cli-zm7njwzd.js";
@@ -35,18 +35,18 @@ import"./cli-e7d20cty.js";
 import"./cli-3dpj7atn.js";
 import"./cli-y89t4nca.js";
 import"./cli-f14fvzag.js";
-import"./cli-m9sxbkhm.js";
+import"./cli-zvz62chv.js";
 import"./cli-bsakbbkm.js";
 import"./cli-9d8ntetj.js";
-import"./cli-y6b6fb76.js";
-import"./cli-kpv03zhj.js";
+import"./cli-08b07b4r.js";
+import"./cli-3apbzgyk.js";
 import"./cli-e29gmdmw.js";
 import"./cli-c2mk1kgf.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-anedxf1w.js";
-import"./cli-xqcq9y5e.js";
+import"./cli-kjwt6hdf.js";
+import"./cli-r2ap2czm.js";
 import"./cli-knd276ed.js";
 import"./cli-c4eeb5q2.js";
 import"./cli-btbzvq95.js";

package/dist/{claude-managed-adapter-sactwn31.js → claude-managed-adapter-qvsmh6mv.js}

@@ -3,13 +3,13 @@ import {
   checkClaudeManagedCredentials,
   composeManagedUserMessage,
   normalizeRepoUrl
-} from "./cli-cn6mmc7f.js";
+} from "./cli-6664w7y4.js";
 import"./cli-hsxj0yar.js";
 import"./cli-2djtr51b.js";
 import"./cli-j490egb5.js";
 import"./cli-hp1n6zq3.js";
 import"./cli-s25avqg9.js";
-import"./cli-xqcq9y5e.js";
+import"./cli-r2ap2czm.js";
 import"./cli-bc05qbss.js";
 export {
   ClaudeManagedAdapter,

package/dist/{claude-sdk-session-v8w0s7qm.js → claude-sdk-session-2yxgjs5d.js}

@@ -3,15 +3,15 @@ import {
   cleanupTaskFile,
   normalizeClaudeMessage,
   runClaudeSessionSummary
-} from "./cli-m1p5cysp.js";
-import"./cli-brxyat7h.js";
-import"./cli-d8brzxjb.js";
+} from "./cli-7smrsr25.js";
+import"./cli-cr12paw2.js";
+import"./cli-4wtq5jjv.js";
 import {
   SessionErrorTracker,
   parseStderrForErrors,
   trackErrorFromJson
 } from "./cli-b5b30yzk.js";
-import"./cli-rvqz34y5.js";
+import"./cli-jecc01cb.js";
 import"./cli-hp1n6zq3.js";
 import"./cli-tng3131n.js";
 import"./cli-zm7njwzd.js";
@@ -32,21 +32,21 @@ import {
   terminateProcessGroup
 } from "./cli-y89t4nca.js";
 import"./cli-f14fvzag.js";
-import"./cli-m9sxbkhm.js";
+import"./cli-zvz62chv.js";
 import"./cli-bsakbbkm.js";
 import"./cli-9d8ntetj.js";
-import"./cli-y6b6fb76.js";
-import"./cli-kpv03zhj.js";
+import"./cli-08b07b4r.js";
+import"./cli-3apbzgyk.js";
 import"./cli-e29gmdmw.js";
 import"./cli-c2mk1kgf.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-anedxf1w.js";
+import"./cli-kjwt6hdf.js";
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import"./cli-knd276ed.js";
 import"./cli-c4eeb5q2.js";
 import"./cli-btbzvq95.js";

package/dist/{cli-y6b6fb76.js → cli-08b07b4r.js}

@@ -6,7 +6,7 @@ import {
   isSteeringEnabled,
   registerTemplate,
   resolveTemplateAsync
-} from "./cli-kpv03zhj.js";
+} from "./cli-3apbzgyk.js";
 import {
   __esm
 } from "./cli-bc05qbss.js";

package/dist/{cli-8fc8de14.js → cli-0z2v4nhw.js}

@@ -3,7 +3,7 @@ import {
   registerVolatileSecret,
   scrubObject,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 
 // src/x/composio.ts
 init_secret_scrubber();

package/dist/{cli-tebsjpk7.js → cli-19f354qr.js}

@@ -7,14 +7,14 @@ import {
   restoreScratchScriptLastUsedIfUnchanged,
   runScript,
   touchScratchScriptLastUsed
-} from "./cli-0er5m69z.js";
+} from "./cli-aae6hz6a.js";
 import {
   defaultAssetKey,
   getDbClient,
   getLeadAgent,
   init_db,
   init_key
-} from "./cli-6s2y152y.js";
+} from "./cli-yab68w40.js";
 import {
   init_zod
 } from "./cli-sd0mxa3c.js";

package/dist/{cli-kzvhgvk3.js → cli-2qts1hys.js}

@@ -4,15 +4,15 @@ import {
   getEmbeddingProvider,
   init_embedding,
   serializeEmbedding
-} from "./cli-5khqvvnq.js";
+} from "./cli-3q5ejx9p.js";
 import {
   getDbClient,
   init_db
-} from "./cli-6s2y152y.js";
+} from "./cli-yab68w40.js";
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 
 // src/be/scripts/embeddings.ts
 init_secret_scrubber();

package/dist/{cli-kpv03zhj.js → cli-3apbzgyk.js}

@@ -285,14 +285,15 @@ The task has four endings. When you are done: \`completed\`. When the answer nee
 Your output is delegation and review. Workers implement, research, analyze, and write. Data gathering, even a quick query, goes to a worker. You answer simple factual questions yourself.
 
 \`get-swarm\` is the roster. Route by capability and load.
-Delegate with \`send-task\`. Read a child's result with \`get-task-details\`.
+\`send-task\`: include \`routingReason\` with \`agentId\`. Read results via \`get-task-details\`.
 A task states the goal, the repo URL when there is one, and the constraints. Workers know git, the skills, and \`store-progress\`.
 Delegate by the shape of the work: a workflow for multi-step or fan-out work, a schedule for recurring work, a script for bulk data, an inline \`script-run\` for a one-off bulk job you can run yourself. The \`workflow-iterate\`, \`scheduling\`, and \`swarm-scripts\` skills build them.
 Research or exploration: tell the worker to use the \`researching\` skill. A large feature: a task for the \`planning\` skill first, then a task for the \`implementing\` skill with \`parentTaskId\`. A small fix: direct implementation.
 A follow-up that continues earlier work carries \`parentTaskId\`. The worker receives the prior context.
-A task whose result depends on the workers' output: wait for the children with the \`wait-for-task\` script, then merge and complete the task yourself. A turn that ends with children still running leaves the task unfinished.
 
-A worker's completion or failure arrives as a follow-up task. Review the output and complete the follow-up. The worker's result is the answer. A person decides only when the worker failed and the failure needs a person.
+Worker completion/failure triggers a follow-up by default. For longer work, \`defer-task\` with a wake-up or complete this task. Review the worker's answer and complete the follow-up. Escalate only failures needing a person.
+
+Wait inline via \`wait-for-task\` only for an essential result expected within ~1 minute. Set \`send-task.followUpConfig.disabled=true\`; cap all waits at ~1 minute total. If still running, \`defer-task\` with a wake-up.
 
 A task from an unknown user: register them with \`manage-user\`, then continue.
 Your heartbeat runbook is the \`heartbeatMd\` profile field. Edit it with \`update-profile\`. You MUST use the \`heartbeat-runbook\` skill when you handle a heartbeat checklist task.
@@ -398,16 +399,20 @@ Link env: \`APP_URL\` for pages, \`MCP_BASE_URL\` for the API. Report missing va
     defaultBody: `
 ## How you write
 
-These rules cover everything a person reads from you: Slack, PR and issue comments, tickets, email, pages, task output.
+For human-facing replies and artifacts: lead with the result. Use plain words, active voice, one idea per sentence, and sentence case headings.
+State blockers and reasons. Preserve meaningful uncertainty.
+Omit em dashes, filler, sign-offs, praise, repetition, step narration, and generic offers to elaborate.
+
+Simple replies: one to three sentences. Routine replies: under 120 words, using short paragraphs or up to three bullets.
+Use more detail for requested depth or essential evidence, caveats, or instructions.
+Include context only when it changes understanding or action. Link extensive supporting material when useful, but make the reply self-contained.
+Do not shorten investigation, required artifacts, or schema-defined output to meet reply limits.
 
-Lead with the result. Context comes after.
-One idea per sentence. Active voice with a named actor.
-Sentence case headings. Plain words: use, help, many, if.
-Keep a hedge only when you are unsure. "May have failed" stays "may have failed".
-When something is broken, blocked, or a bad idea, say so and say why.
-Reply in the requester's language, at the depth they asked for. A one-line question gets the answer first.
-A Requester Profile section, when present, wins on tone, depth, and format. Correctness wins over style.
-Em dashes, filler, sign-offs, and praise of the question are out.
+Follow the current request and Requester Profile for language, tone, depth, and format. Correctness wins over style.
+Use the \`comms\` skill when available for requested simplification or clarity rewrites. Ordinary replies need no skill invocation.
+Use Visual mode only for explicit visual requests with delivery tools available in the active channel.
+Requests to show data are not visual requests. New facts, diagnosis, and actions still require work.
+Output schemas and channel delivery rules, including Slack's engine-owned delivery, override skill defaults.
 `,
     variables: [],
     category: "system"
@@ -461,6 +466,13 @@ You may receive steering messages while this task is running. Each one arrives w
     ],
     category: "system"
   });
+  registerTemplate({
+    eventType: "system.agent.tool_preload",
+    header: "",
+    defaultBody: "This session preloads selected swarm tools. If a tool definition is already available in context, call it directly. Use your harness tool search only for tools whose definitions are not yet available.",
+    variables: [],
+    category: "system"
+  });
   registerTemplate({
     eventType: "system.agent.tools_skills",
     header: "",
@@ -521,8 +533,8 @@ This swarm runs in **scripts-only mode**. The ONLY swarm MCP tools available are
 The script authoring contract in the \`swarm-scripts\` skill (entry signature, \`ctx\` shape, secret handling) applies here unchanged. The full SDK is \`ctx.swarm.*\`: task lifecycle (\`task_get\`, \`task_send\`, \`task_storeProgress\`, \`task_action\`, \`task_list\`), Slack (\`slack_reply\`, \`slack_post\`, \`slack_read\`), memory, kv, swarm info (\`swarm_get\`, \`agent_info\`), and more. Responses are usually wrapped; prefer \`res?.data ?? res\`.
 
 **Built-in coordination scripts, USE THESE FIRST (\`script-run\` with \`name\` + \`args\`):**
-- \`delegate\` {agentName, task, parentTaskId?} → subtask for an agent by name; returns {taskId}
-- \`wait-for-task\` {taskId} → waits up to ~25s for a terminal state; returns {done, status, output}; while done=false call it again
+- \`delegate\` {agentName, task, routingReason, parentTaskId?} → subtask for an agent by name; returns {taskId}
+- \`wait-for-task\` {taskId} → waits up to ~25s for a terminal state; returns {done, status, output}; only for a child expected to finish within about a minute whose result the answer requires. Bound all calls to about a minute total; if still done=false, use \`defer-task\` with a wake-up to collect the result.
 - \`get-child-outputs\` {parentTaskId} → all children with status+output
 - \`complete-task\` {taskId, output} → THE way to finish your assigned task
 - \`report-progress\` {taskId, note} → progress update
@@ -532,7 +544,7 @@ Rules of the road:
 - Prefer a built-in script over inline source; write inline TypeScript only for logic no built-in covers. Check \`script-search\` first, and \`script-query-types\` for the live \`swarm-sdk.d.ts\` before authoring anything non-trivial.
 - \`taskId\` is NOT ambient inside scripts; pass it explicitly via \`args\`.
 - Report progress and completion via \`complete-task\` / \`report-progress\` (or \`ctx.swarm.task_storeProgress\` inline). This is how you update, complete, or fail your task; there is no other way.
-- Scripts are killed after ~30s and stdout is capped at 1 MB. Never sleep/loop longer than ~25s inside one script; chain \`wait-for-task\` calls instead.
+- Scripts are killed after ~30s and stdout is capped at 1 MB. Never sleep/loop longer than ~25s inside one script. Default to the child's automatic follow-up; chained \`wait-for-task\` calls are only for the inline exception above and must stay within about a minute total.
 - Aggregate inside the script and return only the derived result; never dump raw data.
 - Batch related SDK calls into a single script when it reduces round trips.
 `,

package/dist/{cli-5khqvvnq.js → cli-3q5ejx9p.js}

@@ -1,7 +1,7 @@
 import {
   contentSha256,
   init_profile_sync
-} from "./cli-m9sxbkhm.js";
+} from "./cli-zvz62chv.js";
 import {
   OpenAI,
   init_openai
@@ -11,7 +11,7 @@ import {
   getDbClient,
   init_db,
   isSqliteVecAvailable
-} from "./cli-6s2y152y.js";
+} from "./cli-yab68w40.js";
 import {
   __esm,
   __export,

package/dist/{cli-d8brzxjb.js → cli-4wtq5jjv.js}

@@ -13,11 +13,11 @@ import {
   parseClaudeMdPendingRecord,
   planClaudeMdSync,
   withFileLock
-} from "./cli-m9sxbkhm.js";
+} from "./cli-zvz62chv.js";
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 
 // src/commands/claude-md-session.ts
 init_file_lock();

package/dist/{cli-ct0et58h.js → cli-5my3bjsd.js}

@@ -35,7 +35,7 @@ import {
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import {
   __toESM
 } from "./cli-bc05qbss.js";

package/dist/{cli-cn6mmc7f.js → cli-6664w7y4.js}

@@ -19,7 +19,7 @@ import {
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 
 // src/providers/claude-managed-adapter.ts
 init_secret_scrubber();