@desplega.ai/agent-swarm 1.59.0 → 1.59.1

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.59.0",
+    "version": "1.59.1",
     "description": "Multi-agent orchestration API for Claude Code, Codex, and Gemini CLI. Enables task distribution, agent communication, and service discovery.\n\nMCP tools are documented separately in [MCP.md](./MCP.md)."
   },
   "servers": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.59.0",
+  "version": "1.59.1",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",

package/src/commands/runner.ts

@@ -2170,6 +2170,8 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
 
   // Per-task repo context — set when processing a task with githubRepo
   let currentRepoContext: BasePromptArgs["repoContext"] | undefined;
+  // Slack context for current task (gates Slack instructions in prompt)
+  let currentTaskSlackContext: BasePromptArgs["slackContext"] | undefined;
 
   // Generate base prompt (identity fields injected after profile fetch below)
   const buildSystemPrompt = async () => {
@@ -2185,6 +2187,7 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
       toolsMd: agentToolsMd,
       claudeMd: agentClaudeMd,
       repoContext: currentRepoContext,
+      slackContext: currentTaskSlackContext,
       skillsSummary: agentSkillsSummary,
       mcpServersSummary: agentMcpServersSummary,
     });
@@ -2923,6 +2926,15 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
           // Extract model from task data for per-task model selection
           const taskModel = (trigger.task as { model?: string } | undefined)?.model;
 
+          // Detect Slack context for conditional prompt sections
+          const taskSlackChannelId = (trigger.task as { slackChannelId?: string } | undefined)
+            ?.slackChannelId;
+          const taskSlackThreadTs = (trigger.task as { slackThreadTs?: string } | undefined)
+            ?.slackThreadTs;
+          currentTaskSlackContext = taskSlackChannelId
+            ? { channelId: taskSlackChannelId, threadTs: taskSlackThreadTs }
+            : undefined;
+
           // Handle repo context for tasks with vcsRepo (GitHub/GitLab)
           const taskVcsRepo = (trigger.task as { vcsRepo?: string } | undefined)?.vcsRepo;
           if (taskVcsRepo && apiUrl) {

package/src/prompts/base-prompt.ts

@@ -44,6 +44,8 @@ export type BasePromptArgs = {
       review: string[];
     } | null;
   };
+  /** Slack context from the current task, if present */
+  slackContext?: { channelId: string; threadTs?: string };
   /** Pre-fetched skill summaries for the installed skills section */
   skillsSummary?: { name: string; description: string }[];
   /** Pre-fetched MCP server summaries for the installed MCP servers section */
@@ -60,6 +62,15 @@ export const getBasePrompt = async (args: BasePromptArgs): Promise<string> => {
   const compositeResult = await resolveTemplateAsync(compositeEventType, vars);
   let prompt = compositeResult.text;
 
+  // Conditionally inject Slack instructions for workers with Slack-originated tasks
+  if (role !== "lead" && args.slackContext) {
+    const slackResult = await resolveTemplateAsync("system.agent.worker.slack", {
+      slackChannelId: args.slackContext.channelId,
+      slackThreadTs: args.slackContext.threadTs ?? "",
+    });
+    prompt += slackResult.text;
+  }
+
   // Inject agent identity (soul + identity + name/description) if available
   if (args.soulMd || args.identityMd || args.name) {
     prompt += "\n\n## Your Identity\n\n";

package/src/prompts/session-templates.ts

@@ -133,16 +133,6 @@ As a worker agent of the swarm, you are responsible for executing tasks assigned
 - \`store-progress\`: Save your work progress on tasks (critical!)
 - \`task-action\`: Manage tasks - claim from pool, release, accept/reject offered tasks
 - \`read-messages\`: Read messages from the lead or other workers
-- \`slack-reply\`: Reply to a Slack thread (use taskId for context — only works when your task has Slack metadata)
-
-#### Slack Thread Updates
-
-When your task has Slack metadata (slackChannelId/slackThreadTs), you MUST keep the originating Slack thread informed:
-- **On start**: Post a brief update that you've picked up the task
-- **On completion**: Post a summary of the result using \`slack-reply\` with your taskId
-- **On failure**: Post what went wrong so the requester knows immediately
-
-This ensures humans who requested work via Slack get timely feedback without having to check the dashboard.
 
 #### Completing Tasks
 
@@ -156,6 +146,26 @@ Always include meaningful output - the lead agent reviews your work.
   category: "system",
 });
 
+registerTemplate({
+  eventType: "system.agent.worker.slack",
+  header: "",
+  defaultBody: `
+#### Slack Thread Updates
+
+This task originated from Slack (channel: \`{{slackChannelId}}\`). You MUST keep the originating Slack thread informed:
+- **On start**: Post a brief update that you've picked up the task using \`slack-reply\` with your taskId
+- **On completion**: Post a summary of the result using \`slack-reply\` with your taskId
+- **On failure**: Post what went wrong so the requester knows immediately
+
+This ensures humans who requested work via Slack get timely feedback without having to check the dashboard.
+`,
+  variables: [
+    { name: "slackChannelId", description: "The Slack channel ID for the originating thread" },
+    { name: "slackThreadTs", description: "The Slack thread timestamp" },
+  ],
+  category: "system",
+});
+
 registerTemplate({
   eventType: "system.agent.filesystem",
   header: "",

package/src/tests/prompt-template-session.test.ts

@@ -54,12 +54,13 @@ describe("Session templates — registration", () => {
     await ensureTemplatesRegistered();
   });
 
-  test("all 12 system templates are registered", () => {
+  test("all 13 system templates are registered", () => {
     const systemTemplates = [
       "system.agent.role",
       "system.agent.register",
       "system.agent.lead",
       "system.agent.worker",
+      "system.agent.worker.slack",
       "system.agent.filesystem",
       "system.agent.agent_fs",
       "system.agent.self_awareness",
@@ -90,7 +91,7 @@ describe("Session templates — registration", () => {
   test("total of 15 session/system templates registered", () => {
     const all = getAllTemplateDefinitions();
     const sessionSystem = all.filter((d) => d.category === "system" || d.category === "session");
-    expect(sessionSystem.length).toBe(14);
+    expect(sessionSystem.length).toBe(15);
   });
 });
 

package/src/tests/tool-annotations.test.ts

@@ -178,8 +178,8 @@ describe("Tool Annotations & Classification", () => {
     expect(overlap).toEqual([]);
   });
 
-  test("CORE_TOOLS contains exactly 15 tools", () => {
-    expect(CORE_TOOLS.size).toBe(15);
+  test("CORE_TOOLS contains exactly 13 tools", () => {
+    expect(CORE_TOOLS.size).toBe(13);
   });
 
   test("ALL_TOOLS equals CORE_TOOLS union DEFERRED_TOOLS", () => {
@@ -237,7 +237,7 @@ describe("Tool Annotations & Classification", () => {
   });
 
   test("core tools include essential communication tools", () => {
-    const commTools = ["read-messages", "post-message", "slack-reply", "slack-read"];
+    const commTools = ["read-messages", "post-message"];
     for (const tool of commTools) {
       expect(CORE_TOOLS.has(tool)).toBe(true);
     }

package/src/tools/tool-config.ts

@@ -26,8 +26,6 @@ export const CORE_TOOLS = new Set([
   // Communication (used every session)
   "read-messages", // internal swarm chat
   "post-message", // internal swarm chat
-  "slack-reply", // respond to Slack threads
-  "slack-read", // read Slack thread history
 
   // Memory (used at session start)
   "memory-search", // recall relevant context
@@ -81,7 +79,9 @@ export const DEFERRED_TOOLS = new Set([
   "context-history",
   "context-diff",
 
-  // Slack extras (4)
+  // Slack (6)
+  "slack-reply",
+  "slack-read",
   "slack-upload-file",
   "slack-download-file",
   "slack-list-channels",