@desplega.ai/agent-swarm 1.122.0 → 1.123.0

package/README.md

@@ -127,6 +127,8 @@ Check [our templates](https://templates.agent-swarm.dev) for a quick start.
 - **Multi-channel inputs** — Slack, GitHub, GitLab, email, WhatsApp, Linear, Jira, and the HTTP API all create tasks. [Integrations](#integrations)
 - **Workflow engine with Human-in-the-Loop** — DAG-based automation with approval gates, retries, and structured I/O. [Workflows →](https://docs.agent-swarm.dev/docs/concepts/workflows)
 - **Scheduled & recurring tasks** — cron-based automation for standing work, with schedules that can target agent tasks, workflows, or catalog scripts. [Scheduling →](https://docs.agent-swarm.dev/docs/concepts/scheduling)
+- **Mid-run task steering** — add context at the next turn boundary, request an immediate interrupt where the harness supports it, or degrade safely to a follow-up task. [Task steering →](https://docs.agent-swarm.dev/docs/guides/task-steering)
+- **Operator configuration UI** — tune non-secret feature flags, limits, integration toggles, and runtime defaults from Settings → Configuration, with source and restart-required indicators. [Configuration →](https://docs.agent-swarm.dev/docs/ui/configuration)
 - **Asset namespaces** — group tasks, workflows, schedules, pages, and mapped files under canonical shared or personal keys, with inheritance, subtree filtering, audited moves, and cross-entity discovery. [Asset namespaces →](https://docs.agent-swarm.dev/docs/guides/asset-namespaces)
 - **Persistent shared files via agent-fs** — co-deploy agent-fs for shared task attachments, previews, and search; late provisioning or config reloads activate the provider without an API restart, and tenant-authenticated control planes can invite shared-org members without receiving the bootstrap key. [Co-deployment guide →](https://docs.agent-swarm.dev/docs/guides/agent-fs-co-deployment)
 - **Durable script workflows** — launch background script runs, inspect their journals, and track them from the dashboard when a one-shot `script-run` is too small. [Guide →](https://docs.agent-swarm.dev/docs/guides/script-workflow-runs)

package/dist/{actions-k3bwtmgy.js → actions-e4c9f0xy.js}

@@ -1,14 +1,14 @@
 import {
   resolveSlackUserId
-} from "./cli-bxdb36d2.js";
-import"./cli-3ptjc655.js";
+} from "./cli-n8mf7x4b.js";
+import"./cli-1592nfd6.js";
 import {
   createTaskWithSiblingAwareness
-} from "./cli-00yr0kxv.js";
+} from "./cli-kmm1rwmp.js";
 import {
   buildCancelledBlocks,
   getTaskLink
-} from "./cli-ma04faw5.js";
+} from "./cli-5arfywtm.js";
 import"./cli-wspgs9bt.js";
 import"./cli-dh55d5fg.js";
 import {
@@ -19,9 +19,9 @@ import {
   init_context_key,
   init_db,
   slackContextKey
-} from "./cli-mjxnr12j.js";
+} from "./cli-8cq4z4x7.js";
 import"./cli-z2zcxes1.js";
-import"./cli-w48hgc2y.js";
+import"./cli-h2say6xk.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{app-knevny0f.js → app-vmvmj2v3.js}

@@ -3,15 +3,15 @@ import {
   initSlackApp,
   startSlackApp,
   stopSlackApp
-} from "./cli-9fhxk91h.js";
+} from "./cli-fjf04hpa.js";
 import"./cli-rkndnn90.js";
 import"./cli-b0p7rfnd.js";
-import"./cli-ma04faw5.js";
+import"./cli-5arfywtm.js";
 import"./cli-wspgs9bt.js";
 import"./cli-dh55d5fg.js";
-import"./cli-mjxnr12j.js";
+import"./cli-8cq4z4x7.js";
 import"./cli-z2zcxes1.js";
-import"./cli-w48hgc2y.js";
+import"./cli-h2say6xk.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{assistant-as8087ft.js → assistant-yn7a792a.js}

@@ -1,24 +1,24 @@
 import {
   bufferThreadMessage,
   wasEventSeen
-} from "./cli-kpfsabp2.js";
+} from "./cli-we91ywvy.js";
 import {
   hasOtherUserMention
-} from "./cli-fc1gvt9c.js";
+} from "./cli-3tv9z4wx.js";
 import {
   resolveSlackUserId,
   rewriteSlackMentions
-} from "./cli-bxdb36d2.js";
-import"./cli-3ptjc655.js";
+} from "./cli-n8mf7x4b.js";
+import"./cli-1592nfd6.js";
 import {
   createTaskWithSiblingAwareness
-} from "./cli-00yr0kxv.js";
+} from "./cli-kmm1rwmp.js";
 import {
   require_dist
-} from "./cli-9fhxk91h.js";
+} from "./cli-fjf04hpa.js";
 import"./cli-rkndnn90.js";
 import"./cli-b0p7rfnd.js";
-import"./cli-ma04faw5.js";
+import"./cli-5arfywtm.js";
 import"./cli-wspgs9bt.js";
 import"./cli-dh55d5fg.js";
 import {
@@ -27,12 +27,14 @@ import {
   getMostRecentTaskInThread,
   init_context_key,
   init_db,
+  init_env_flag,
   init_resolver,
+  isEnvFlagEnabled,
   resolveTemplate,
   slackContextKey
-} from "./cli-mjxnr12j.js";
+} from "./cli-8cq4z4x7.js";
 import"./cli-z2zcxes1.js";
-import"./cli-w48hgc2y.js";
+import"./cli-h2say6xk.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";
@@ -47,7 +49,8 @@ init_db();
 init_resolver();
 init_context_key();
 var import_bolt = __toESM(require_dist(), 1);
-var additiveSlack = process.env.ADDITIVE_SLACK === "true";
+init_env_flag();
+var isAdditiveSlack = () => isEnvFlagEnabled("ADDITIVE_SLACK", false);
 var cachedBotUserId = null;
 function createAssistant() {
   return new import_bolt.Assistant({
@@ -119,7 +122,7 @@ function createAssistant() {
         }) : undefined;
         const workingAgent = getAgentWorkingOnThread(channelId, threadTs);
         if (workingAgent && workingAgent.status !== "offline") {
-          if (additiveSlack) {
+          if (isAdditiveSlack()) {
             bufferThreadMessage(channelId, threadTs, messageText, userId, message.ts);
             await safeSetStatus("Queuing follow-up...");
             return;

package/dist/{boot-reembed-j305cpdr.js → boot-reembed-chxty50a.js}

@@ -1,15 +1,15 @@
 import {
   embedScript,
   embeddingProvider
-} from "./cli-60q15ncp.js";
-import"./cli-qf0qxzw5.js";
+} from "./cli-byv3720g.js";
+import"./cli-zdp11t8m.js";
 import"./cli-q25ejbyn.js";
 import {
   getDb,
   init_db
-} from "./cli-mjxnr12j.js";
+} from "./cli-8cq4z4x7.js";
 import"./cli-z2zcxes1.js";
-import"./cli-w48hgc2y.js";
+import"./cli-h2say6xk.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{boot-reembed-1dcc1yyk.js → boot-reembed-xg1r86h2.js}

@@ -3,14 +3,14 @@ import {
   getEmbeddingProvider,
   getMemoryStore,
   init_constants
-} from "./cli-qf0qxzw5.js";
+} from "./cli-zdp11t8m.js";
 import"./cli-q25ejbyn.js";
 import {
   getDb,
   init_db
-} from "./cli-mjxnr12j.js";
+} from "./cli-8cq4z4x7.js";
 import"./cli-z2zcxes1.js";
-import"./cli-w48hgc2y.js";
+import"./cli-h2say6xk.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{boot-scrub-logs-w9qkjzkm.js → boot-scrub-logs-exwddvp5.js}

@@ -1,9 +1,9 @@
 import {
   getDb,
   init_db
-} from "./cli-mjxnr12j.js";
+} from "./cli-8cq4z4x7.js";
 import"./cli-z2zcxes1.js";
-import"./cli-w48hgc2y.js";
+import"./cli-h2say6xk.js";
 import {
   init_secret_scrubber,
   scrubSecrets

package/dist/{claude-adapter-vxvcym3r.js → claude-adapter-zvzp4x76.js}

@@ -12,7 +12,7 @@ import {
   resolveClaudeBinary,
   resolveClaudeBinaryArgv,
   resolveClaudeBridgeEnabled
-} from "./cli-x4apc9t3.js";
+} from "./cli-36dctyg8.js";
 import"./cli-psrqtw2m.js";
 import"./cli-tng3131n.js";
 import"./cli-zm7njwzd.js";

package/dist/{claude-managed-adapter-g807894s.js → claude-managed-adapter-g92bcm1a.js}

@@ -3,7 +3,7 @@ import {
   checkClaudeManagedCredentials,
   composeManagedUserMessage,
   normalizeRepoUrl
-} from "./cli-5c4327dx.js";
+} from "./cli-jj1arm18.js";
 import"./cli-07er7wrs.js";
 import"./cli-yv9dttkh.js";
 import"./cli-d6n0thxw.js";

package/dist/{cli-3ptjc655.js → cli-1592nfd6.js}

@@ -4,7 +4,7 @@ import {
   incrKv,
   init_db,
   upsertKv
-} from "./cli-mjxnr12j.js";
+} from "./cli-8cq4z4x7.js";
 
 // src/be/users.ts
 init_db();

package/dist/{cli-x4apc9t3.js → cli-36dctyg8.js}

@@ -71,6 +71,38 @@ function parseClaudeBinary(raw) {
     return ["claude"];
   return trimmed.split(/\s+/);
 }
+var MIN_CLAUDE_QUEUE_STEERING_VERSION = [2, 1, 205];
+function resolveClaudeQueueSteeringOverride(env) {
+  const raw = env.CLAUDE_QUEUE_STEERING?.trim().toLowerCase();
+  if (!raw)
+    return;
+  if (["0", "false", "off", "no"].includes(raw))
+    return false;
+  if (["1", "true", "on", "yes"].includes(raw))
+    return true;
+  return;
+}
+function supportsClaudeQueueSteering(versionOutput) {
+  const match = versionOutput?.match(/claude(?: code)? version:\s*(\d+)\.(\d+)\.(\d+)/i) ?? versionOutput?.match(/(\d+)\.(\d+)\.(\d+)\s*\(Claude Code\)/i);
+  if (!match)
+    return false;
+  const detected = match.slice(1, 4).map(Number);
+  for (let index = 0;index < MIN_CLAUDE_QUEUE_STEERING_VERSION.length; index++) {
+    const actual = detected[index] ?? 0;
+    const minimum = MIN_CLAUDE_QUEUE_STEERING_VERSION[index] ?? 0;
+    if (actual !== minimum)
+      return actual > minimum;
+  }
+  return true;
+}
+function claudeUserMessage(text) {
+  return `${JSON.stringify({
+    type: "user",
+    message: { role: "user", content: text },
+    parent_tool_use_id: null
+  })}
+`;
+}
 function resolveClaudeBinary(resolvedEnv, fallbackEnv = process.env) {
   const candidate = resolvedEnv.CLAUDE_BINARY?.trim() || fallbackEnv.CLAUDE_BINARY?.trim();
   return candidate || "claude";
@@ -247,7 +279,9 @@ class ClaudeSession {
   claudeBinaryArgv;
   harnessVariant;
   harnessVariantMeta;
+  queueSteeringSupported;
   proc;
+  stdinWriter;
   listeners = [];
   eventQueue = [];
   _sessionId;
@@ -257,13 +291,15 @@ class ClaudeSession {
   contextWindowSize;
   systemPromptFile;
   appliedReasoningEffort;
-  constructor(config, model, taskFilePath, taskFilePid, sessionMcpConfig = null, claudeBinaryArgv = ["claude"], systemPromptFile = null, harnessVariant, harnessVariantMeta) {
+  deliverSteering;
+  constructor(config, model, taskFilePath, taskFilePid, sessionMcpConfig = null, claudeBinaryArgv = ["claude"], systemPromptFile = null, harnessVariant, harnessVariantMeta, queueSteeringSupported = false) {
     this.config = config;
     this.model = model;
     this.sessionMcpConfig = sessionMcpConfig;
     this.claudeBinaryArgv = claudeBinaryArgv;
     this.harnessVariant = harnessVariant;
     this.harnessVariantMeta = harnessVariantMeta;
+    this.queueSteeringSupported = queueSteeringSupported;
     this.taskFilePid = taskFilePid;
     this.contextWindowSize = getContextWindowSize(model);
     this.systemPromptFile = systemPromptFile;
@@ -289,11 +325,60 @@ class ClaudeSession {
         ...sourceEnv.CLAUDE_CODE_OAUTH_TOKEN ? { AGENT_SWARM_CLAUDE_OAUTH_TOKEN: sourceEnv.CLAUDE_CODE_OAUTH_TOKEN } : {},
         CONTEXT_MODE_EXTERNAL_MCP_NUDGE_EVERY: CTX_MODE_NUDGE_EVERY
       },
+      ...this.queueSteeringSupported ? { stdin: "pipe" } : {},
       stdout: "pipe",
       stderr: "pipe"
     });
+    if (this.queueSteeringSupported) {
+      const stdin = this.proc.stdin;
+      if (stdin && typeof stdin !== "number") {
+        this.stdinWriter = stdin;
+        this.writeUserMessage(this.config.prompt).catch((err) => {
+          console.warn(`\x1B[33m[claude]\x1B[0m Failed to write initial prompt to Claude stdin: ${scrubSecrets(String(err))}`);
+          this.closeStdin();
+          try {
+            this.proc.kill("SIGTERM");
+          } catch {}
+        });
+      } else {
+        console.warn("\x1B[33m[claude]\x1B[0m Claude stdin was not piped; terminating the session to avoid waiting without a prompt.");
+        try {
+          this.proc.kill("SIGTERM");
+        } catch {}
+      }
+    }
+    if (this.queueSteeringSupported && this.stdinWriter) {
+      this.deliverSteering = async ({
+        mode,
+        text
+      }) => {
+        if (mode === "steer") {
+          console.warn("[claude-adapter] Interrupt requested; raw Claude CLI supports queued steering only, so the message will run at the next turn boundary.");
+        }
+        if (!this.stdinWriter) {
+          return { delivered: false, reason: "Claude stdin is closed" };
+        }
+        try {
+          await this.writeUserMessage(text);
+          return { delivered: true, mode: "queue" };
+        } catch (err) {
+          this.closeStdin();
+          return {
+            delivered: false,
+            reason: `Claude stdin write failed: ${String(err)}`
+          };
+        }
+      };
+    }
     this.completionPromise = this.processStreams();
   }
+  async writeUserMessage(text) {
+    const writer = this.stdinWriter;
+    if (!writer)
+      throw new Error("Claude stdin is closed");
+    await writer.write(claudeUserMessage(text));
+    await writer.flush?.();
+  }
   buildCommand() {
     const cmd = [
       ...this.claudeBinaryArgv,
@@ -305,10 +390,13 @@ class ClaudeSession {
       "--dangerously-skip-permissions",
       "--allow-dangerously-skip-permissions",
       "--permission-mode",
-      "bypassPermissions",
-      "-p",
-      this.config.prompt
+      "bypassPermissions"
     ];
+    if (this.queueSteeringSupported) {
+      cmd.push("--input-format", "stream-json");
+    } else {
+      cmd.push("-p", this.config.prompt);
+    }
     if (this.config.additionalArgs?.length) {
       cmd.push(...this.config.additionalArgs);
     }
@@ -331,6 +419,16 @@ class ClaudeSession {
       this.eventQueue.push(event);
     }
   }
+  closeStdin() {
+    const writer = this.stdinWriter;
+    this.stdinWriter = undefined;
+    if (!writer)
+      return;
+    try {
+      const result = writer.end();
+      Promise.resolve(result).catch(() => {});
+    } catch {}
+  }
   async processStreams() {
     const logFileHandle = Bun.file(this.config.logFile).writer();
     let stderrOutput = "";
@@ -383,7 +481,11 @@ class ClaudeSession {
         this.emit({ type: "raw_stderr", content: scrubbedText });
       }
     })();
-    await Promise.all([stdoutPromise, stderrPromise]);
+    try {
+      await Promise.all([stdoutPromise, stderrPromise]);
+    } finally {
+      this.closeStdin();
+    }
     await logFileHandle.end();
     const exitCode = await this.proc.exited;
     await cleanupTaskFile(this.taskFilePid);
@@ -422,6 +524,9 @@ ${scrubSecrets(stderrOutput)}`);
   processJsonLine(trimmed, setCost) {
     try {
       const json = JSON.parse(trimmed);
+      if (json.type === "result") {
+        this.closeStdin();
+      }
       if (json.type === "system" && json.subtype === "init" && json.session_id) {
         this._sessionId = json.session_id;
         this.emit({
@@ -527,13 +632,20 @@ ${scrubSecrets(stderrOutput)}`);
     return this.completionPromise;
   }
   async abort() {
-    this.proc.kill("SIGTERM");
+    this.closeStdin();
+    try {
+      this.proc.kill("SIGTERM");
+    } catch {}
   }
 }
 
 class ClaudeAdapter {
   name = "claude";
-  traits = { hasMcp: true, hasLocalEnvironment: true };
+  traits = {
+    hasMcp: true,
+    hasLocalEnvironment: true,
+    steerModes: ["queue"]
+  };
   async createSession(config) {
     if (config.resumeSessionId) {
       console.warn("[claude-adapter] resumeSessionId ignored — native resume is disabled by deprecation plan");
@@ -594,24 +706,28 @@ class ClaudeAdapter {
     }
     const harnessVariant = useClaudeBridge ? "bridge" : "stock";
     let harnessVariantMeta;
-    if (useClaudeBridge) {
-      try {
-        const bin = effectiveClaudeBinaryArgv[0] ?? "claude-bridge";
-        const result = await Bun.$`${bin} --version`.quiet();
-        const trimmed = result.text().trim();
-        if (trimmed)
-          harnessVariantMeta = { version: trimmed };
-      } catch {}
-    } else {
-      try {
-        const bin = effectiveClaudeBinaryArgv[0] ?? "claude";
-        const result = await Bun.$`${bin} --version`.quiet();
-        const trimmed = result.text().trim();
-        if (trimmed)
+    const queueSteeringOverride = resolveClaudeQueueSteeringOverride(sourceEnv);
+    let harnessVersion;
+    try {
+      const result = Bun.spawnSync([...effectiveClaudeBinaryArgv, "--version"], {
+        env: sourceEnv,
+        stdout: "pipe",
+        stderr: "pipe"
+      });
+      if (result.success) {
+        const trimmed = `${result.stdout?.toString() ?? ""}
+${result.stderr?.toString() ?? ""}`.trim();
+        if (trimmed) {
+          harnessVersion = trimmed;
           harnessVariantMeta = { version: trimmed };
-      } catch {}
+        }
+      }
+    } catch {}
+    const queueSteeringSupported = queueSteeringOverride ?? (!isInteractiveTmuxClaude && supportsClaudeQueueSteering(harnessVersion));
+    if (!queueSteeringSupported && queueSteeringOverride === undefined) {
+      console.warn(`\x1B[33m[claude]\x1B[0m Queued steering requires Claude Code >= ${MIN_CLAUDE_QUEUE_STEERING_VERSION.join(".")}; detected ${harnessVersion ?? "an unknown version"}. Steering messages will be promoted to follow-up tasks.`);
     }
-    return new ClaudeSession(config, model, taskFilePath, taskFilePid, sessionMcpConfig, effectiveClaudeBinaryArgv, systemPromptFile, harnessVariant, harnessVariantMeta);
+    return new ClaudeSession(config, model, taskFilePath, taskFilePid, sessionMcpConfig, effectiveClaudeBinaryArgv, systemPromptFile, harnessVariant, harnessVariantMeta, queueSteeringSupported);
   }
   async canResume(_sessionId) {
     return true;

package/dist/{cli-fc1gvt9c.js → cli-3tv9z4wx.js}

@@ -2,18 +2,21 @@ import {
   getAgentById,
   getAgentWorkingOnThread,
   getAllAgents,
-  init_db
-} from "./cli-mjxnr12j.js";
+  init_db,
+  init_env_flag,
+  isEnvFlagEnabled
+} from "./cli-8cq4z4x7.js";
 
 // src/slack/router.ts
 init_db();
+init_env_flag();
 function hasOtherUserMention(text, botUserId) {
   const mentions = text.match(/<@([A-Z0-9]+)>/g) ?? [];
   return mentions.some((m) => m !== `<@${botUserId}>`);
 }
 function routeMessage(text, botUserId, botMentioned, threadContext) {
   const matches = [];
-  const requireMentionForThreadFollowup = process.env.SLACK_THREAD_FOLLOWUP_REQUIRE_MENTION === "true";
+  const requireMentionForThreadFollowup = isEnvFlagEnabled("SLACK_THREAD_FOLLOWUP_REQUIRE_MENTION", false);
   const agents = getAllAgents().filter((a) => a.status !== "offline");
   const idMatches = text.matchAll(/swarm#([a-f0-9-]{36})/gi);
   for (const match of idMatches) {