@desplega.ai/agent-swarm 1.122.0 → 1.123.0

package/dist/{cli-wmx631p8.js → cli-4509mwm5.js}

@@ -1,15 +1,15 @@
 import {
   checkCodexCredentials
-} from "./cli-zweca3q3.js";
+} from "./cli-exfs8aym.js";
 import {
   checkClaudeManagedCredentials
-} from "./cli-5c4327dx.js";
+} from "./cli-jj1arm18.js";
 import {
   checkDevinCredentials
-} from "./cli-tyfxrrdd.js";
+} from "./cli-w5r4wfm5.js";
 import {
   checkOpencodeCredentials
-} from "./cli-16dv125e.js";
+} from "./cli-peaqed7c.js";
 import {
   initOtel,
   injectTraceContext,
@@ -19,7 +19,7 @@ import {
   withSpan,
   withSpanContext,
   writeSkillsToFilesystem
-} from "./cli-y3an9mk7.js";
+} from "./cli-mkpf4ndf.js";
 import {
   authJsonToCredentialSelection,
   credentialsToAuthJson,
@@ -27,7 +27,7 @@ import {
 } from "./cli-tk9vyqzh.js";
 import {
   checkClaudeCredentials
-} from "./cli-x4apc9t3.js";
+} from "./cli-36dctyg8.js";
 import {
   MAX_RATE_LIMIT_RESET_MS,
   isCodexCreditsExhaustedMessage,
@@ -41,10 +41,10 @@ import {
 import {
   ensure,
   initialize
-} from "./cli-586x669g.js";
+} from "./cli-hbbxmhec.js";
 import {
   validateJsonSchema
-} from "./cli-m7dmk462.js";
+} from "./cli-822d4bjk.js";
 import {
   getApiKey
 } from "./cli-f14fvzag.js";
@@ -75,15 +75,17 @@ import {
   init_defaults,
   init_resolver,
   init_session_templates,
+  init_steering_enabled,
   init_telemetry,
   init_template,
   init_templates,
   init_types,
   interpolate,
+  isSteeringEnabled,
   resolveTaskModelSelection,
   resolveTemplateAsync,
   telemetry
-} from "./cli-mjxnr12j.js";
+} from "./cli-8cq4z4x7.js";
 import {
   init_credentials,
   resolveCredentialPools
@@ -101,6 +103,7 @@ import { existsSync, statSync } from "node:fs";
 import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
 
 // src/prompts/base-prompt.ts
+init_steering_enabled();
 init_resolver();
 init_session_templates();
 var BOOTSTRAP_MAX_CHARS = 20000;
@@ -119,6 +122,7 @@ function areSlackPromptToolsEnabled(env = process.env) {
 var getBasePrompt = async (args) => {
   const { role, agentId, swarmUrl, traits } = args;
   const { hasMcp = true, hasLocalEnvironment: hasLocalEnv = true } = traits ?? {};
+  const steerModes = traits?.steerModes ?? [];
   const vars = { role, agentId, swarmUrl };
   let compositeEventType;
   if (!hasMcp) {
@@ -156,6 +160,10 @@ ${scriptsOnlyResult.text}`;
     const messagingResult = await resolveTemplateAsync("system.agent.messaging", {});
     prompt += messagingResult.text;
   }
+  if (hasMcp && isSteeringEnabled() && steerModes.length > 0 && !scriptsOnlyMode && serverHasCapability("core", true)) {
+    const steeringResult = await resolveTemplateAsync("system.agent.steering", {});
+    prompt += steeringResult.text;
+  }
   if (!hasLocalEnv) {
     prompt += `
 
@@ -457,27 +465,27 @@ async function materializeCodexAuthJson(_slot, creds, deps = {}) {
 async function createProviderAdapter(provider) {
   switch (provider) {
     case "claude": {
-      const { ClaudeAdapter } = await import("./claude-adapter-vxvcym3r.js");
+      const { ClaudeAdapter } = await import("./claude-adapter-zvzp4x76.js");
       return new ClaudeAdapter;
     }
     case "pi": {
-      const { PiMonoAdapter } = await import("./pi-mono-adapter-k3z6e5fn.js");
+      const { PiMonoAdapter } = await import("./pi-mono-adapter-2syx1x4d.js");
       return new PiMonoAdapter;
     }
     case "codex": {
-      const { CodexAdapter } = await import("./codex-adapter-0kv2meed.js");
+      const { CodexAdapter } = await import("./codex-adapter-vcseqpwf.js");
       return new CodexAdapter;
     }
     case "claude-managed": {
-      const { ClaudeManagedAdapter } = await import("./claude-managed-adapter-g807894s.js");
+      const { ClaudeManagedAdapter } = await import("./claude-managed-adapter-g92bcm1a.js");
       return new ClaudeManagedAdapter;
     }
     case "devin": {
-      const { DevinAdapter } = await import("./devin-adapter-pe1cgpd4.js");
+      const { DevinAdapter } = await import("./devin-adapter-8nmsgff3.js");
       return new DevinAdapter;
     }
     case "opencode": {
-      const { OpencodeAdapter } = await import("./opencode-adapter-s3nhtp9m.js");
+      const { OpencodeAdapter } = await import("./opencode-adapter-44z93505.js");
       return new OpencodeAdapter;
     }
     default:
@@ -832,6 +840,7 @@ async function refreshSkillsIfChanged(ctx, lastHashRef, homeOverride) {
 }
 
 // src/commands/runner.ts
+init_steering_enabled();
 init_template();
 
 // src/vcs/index.ts
@@ -845,6 +854,7 @@ function detectVcsProvider(url) {
 
 // src/commands/context-preamble.ts
 init_secret_scrubber();
+init_steering_enabled();
 var CONTEXT_PREAMBLE_MAX_TOKENS = Number(process.env.CONTEXT_PREAMBLE_MAX_TOKENS || "2000");
 var CONTEXT_PREAMBLE_MAX_CHARS = CONTEXT_PREAMBLE_MAX_TOKENS * 4;
 var CONTEXT_PREAMBLE_MAX_ANCESTORS = 5;
@@ -965,6 +975,20 @@ async function fetchSessionLogsForResume(apiUrl, apiKey, taskId) {
     return [];
   }
 }
+async function fetchSteeringMessagesForResume(apiUrl, apiKey, taskId) {
+  const headers = {};
+  if (apiKey)
+    headers.Authorization = `Bearer ${apiKey}`;
+  try {
+    const response = await fetch(`${apiUrl}/api/tasks/${taskId}/steering-messages?status=pending,promoted`, { headers });
+    if (!response.ok)
+      return [];
+    const data = await response.json();
+    return Array.isArray(data.messages) ? data.messages.filter((message) => (message.status === "pending" || message.status === "promoted") && typeof message.body === "string" && typeof message.createdAt === "string") : [];
+  } catch {
+    return [];
+  }
+}
 function summarizeSessionLogLine(line) {
   const ts = line.createdAt.slice(11, 19);
   let parsed;
@@ -1024,13 +1048,20 @@ async function buildResumeContextPreamble(apiUrl, apiKey, parentTaskId) {
   if (!original)
     return null;
   const parent = chain[0] ?? original;
-  const logsBatches = await Promise.all(chain.map((c2) => fetchSessionLogsForResume(apiUrl, apiKey, c2.id)));
+  const steeringEnabled = isSteeringEnabled();
+  const [logsBatches, steeringBatches] = await Promise.all([
+    Promise.all(chain.map((c2) => fetchSessionLogsForResume(apiUrl, apiKey, c2.id))),
+    steeringEnabled ? Promise.all(chain.map((c2) => fetchSteeringMessagesForResume(apiUrl, apiKey, c2.id))) : Promise.resolve([])
+  ]);
   const merged = logsBatches.flat();
   merged.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
   const recentLogs = merged.slice(-CONTEXT_PREAMBLE_RESUME_SESSION_LOG_LIMIT);
+  const steeringMessages = steeringBatches.flat();
+  steeringMessages.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
   const descBudget = Math.floor(CONTEXT_PREAMBLE_RESUME_MAX_CHARS * 0.4);
-  let logsBudget = Math.floor(CONTEXT_PREAMBLE_RESUME_MAX_CHARS * 0.35);
-  let artBudget = Math.floor(CONTEXT_PREAMBLE_RESUME_MAX_CHARS * 0.15);
+  let logsBudget = Math.floor(CONTEXT_PREAMBLE_RESUME_MAX_CHARS * 0.3);
+  let artBudget = Math.floor(CONTEXT_PREAMBLE_RESUME_MAX_CHARS * 0.1);
+  const steeringBudget = Math.floor(CONTEXT_PREAMBLE_RESUME_MAX_CHARS * 0.1);
   const header = [
     `
 ---`,
@@ -1070,6 +1101,17 @@ async function buildResumeContextPreamble(apiUrl, apiKey, parentTaskId) {
   while (logsSection.length > logsBudget && scrubbedSummary.length > 0) {
     scrubbedSummary.shift();
     logsSection = scrubbedSummary.join(`
+`);
+  }
+  const steeringLines = steeringEnabled ? steeringMessages.map((message) => {
+    const ts = message.createdAt.slice(11, 19);
+    return `[${ts}] ${scrubSecrets(message.body)}`;
+  }) : [];
+  let steeringSection = steeringLines.join(`
+`);
+  while (steeringSection.length > steeringBudget && steeringLines.length > 0) {
+    steeringLines.shift();
+    steeringSection = steeringLines.join(`
 `);
   }
   const atts = parent.attachments?.filter((a) => a.name && (a.url || a.path || a.pageId)) ?? [];
@@ -1092,6 +1134,9 @@ async function buildResumeContextPreamble(apiUrl, apiKey, parentTaskId) {
   if (artSection) {
     sections.push("### Artifacts In Flight", "", artSection, "");
   }
+  if (steeringEnabled && steeringSection) {
+    sections.push("### Undelivered Steering Messages", "", steeringSection, "");
+  }
   sections.push("---", "", `To review the full prior session call \`get-task-details\` with taskId \`${original.id}\`.`, "", "---", "");
   let preamble = sections.join(`
 `);
@@ -1125,7 +1170,7 @@ async function checkProviderCredentials(provider, env, opts) {
     case "opencode":
       return checkOpencodeCredentials(env, opts);
     case "pi": {
-      const { checkPiMonoCredentials } = await import("./pi-mono-adapter-k3z6e5fn.js");
+      const { checkPiMonoCredentials } = await import("./pi-mono-adapter-2syx1x4d.js");
       return checkPiMonoCredentials(env, opts);
     }
     default:
@@ -1281,7 +1326,7 @@ async function validateProviderCredentials(provider) {
           };
         }
         const baseUrl = env.DEVIN_API_BASE_URL ?? "https://api.devin.ai";
-        const r = await timedFetch(`${baseUrl.replace(/\/+$/, "")}/v1/sessions?limit=1`, {
+        const r = await timedFetch(`${baseUrl.replace(/\/+$/, "")}/v3/self`, {
           method: "GET",
           headers: {
             Authorization: `Bearer ${apiKey}`,
@@ -1709,6 +1754,78 @@ async function ensureRepoForTask(repoConfig, role, isFirstKickoff = false) {
     return { clonePath: cloneExists ? clonePath : "", claudeMd: null, warning, autoStashes };
   }
 }
+function createSteeringDispatchState() {
+  return {
+    dispatchedIds: new Set,
+    outcomes: new Map
+  };
+}
+async function renderSteeringDelivery(steeringMessageId, body) {
+  try {
+    const result = await resolveTemplateAsync("system.agent.steering.delivery", {
+      steeringMessageId,
+      body
+    });
+    return result.skipped || !result.text.trim() ? body : result.text;
+  } catch {
+    return body;
+  }
+}
+async function pollAndDispatchSteering(config, taskId, session, state, fetchImpl = fetch) {
+  if (!isSteeringEnabled())
+    return;
+  const headers = {
+    Authorization: `Bearer ${config.apiKey}`,
+    "X-Agent-ID": config.agentId
+  };
+  const response = await fetchImpl(`${config.apiUrl}/api/steering-messages?taskId=${encodeURIComponent(taskId)}`, { headers });
+  if (!response.ok) {
+    throw new Error(`Steering poll failed (HTTP ${response.status})`);
+  }
+  const data = await response.json();
+  for (const message of data.messages ?? []) {
+    if (message.status !== "pending")
+      continue;
+    let outcome = state.dispatchedIds.has(message.id) ? state.outcomes.get(message.id) : undefined;
+    if (!outcome) {
+      try {
+        outcome = session.deliverSteering ? await session.deliverSteering({
+          mode: message.mode,
+          text: await renderSteeringDelivery(message.id, message.body)
+        }) : {
+          delivered: false,
+          reason: "Provider session does not support live steering"
+        };
+      } catch (error) {
+        outcome = {
+          delivered: false,
+          reason: scrubSecrets(`Provider steering failed: ${error.message}`)
+        };
+      }
+      if (!outcome.delivered) {
+        outcome = {
+          delivered: false,
+          reason: scrubSecrets(outcome.reason).trim() || "Provider rejected steering without a reason"
+        };
+      }
+      state.dispatchedIds.add(message.id);
+      state.outcomes.set(message.id, outcome);
+    }
+    const endpoint = outcome.delivered ? "delivered" : "undeliverable";
+    const body = outcome.delivered ? { mode: outcome.mode } : { reason: outcome.reason };
+    const reportResponse = await fetchImpl(`${config.apiUrl}/api/steering-messages/${encodeURIComponent(message.id)}/${endpoint}`, {
+      method: "POST",
+      headers: {
+        ...headers,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!reportResponse.ok) {
+      throw new Error(`Steering ${endpoint} report failed (HTTP ${reportResponse.status})`);
+    }
+  }
+}
 async function pingServer(config, _role) {
   const headers = {
     "X-Agent-ID": config.agentId
@@ -1807,7 +1924,13 @@ var RELOADABLE_ENV_KEYS = new Set([
   "REASONING_EFFORT_OVERRIDE",
   "AGENT_FS_SHARED_ORG_ID",
   "SWARM_USE_CLAUDE_BRIDGE",
-  "BEDROCK_AUTH_MODE"
+  "BEDROCK_AUTH_MODE",
+  "STEERING_ENABLED",
+  "ANONYMIZED_TELEMETRY",
+  "MEMORY_RATERS",
+  "TEMPLATE_REGISTRY_URL",
+  "SLACK_DISABLE",
+  "SWARM_ORG_NAME"
 ]);
 function applyResolvedEnvToProcessEnv(freshEnv) {
   const changed = [];
@@ -4006,6 +4129,10 @@ async function runAgent(config, opts) {
     });
     bootModel = bootEnv.env.MODEL_OVERRIDE || bootModel;
     bootCooldownMs = resolveCodexCreditsExhaustedCooldownMs(bootEnv.env.CODEX_CREDITS_EXHAUSTED_COOLDOWN_MS);
+    const bootApplied = applyResolvedEnvToProcessEnv(bootEnv.env);
+    if (bootApplied.length > 0) {
+      console.log(`[runner] Applied resolved swarm config at boot: ${bootApplied.join(", ")}`);
+    }
   } catch (err) {
     console.warn(`[runner] fetchResolvedEnv failed at boot, falling back to env for provider and the default cooldown: ${err}`);
     bootProvider = resolveHarnessProvider({}, process.env);
@@ -4171,6 +4298,7 @@ ${additionalSystemPrompt}` : basePrompt;
     codexCreditsExhaustedCooldownMs: bootCooldownMs
   };
   const cancelledSignaled = new Set;
+  const steeringDispatchState = isSteeringEnabled() ? createSteeringDispatchState() : null;
   let cachedCredHarnessProvider = null;
   let lastHarnessReconcileAt = 0;
   const HARNESS_RECONCILE_INTERVAL_MS = 1e4;
@@ -4754,6 +4882,16 @@ ${additionalSystemPrompt}` : basePrompt;
         } catch {}
       }
     }
+    if (steeringDispatchState && state.activeTasks.size > 0) {
+      const dispatchState = steeringDispatchState;
+      for (const [taskId, task] of state.activeTasks) {
+        try {
+          await pollAndDispatchSteering(apiConfig, taskId, task.session, dispatchState);
+        } catch (error) {
+          console.warn(`[${role}] Steering dispatch failed for task ${taskId.slice(0, 8)} (non-fatal): ${scrubSecrets(error.message)}`);
+        }
+      }
+    }
     if (state.activeTasks.size < state.maxConcurrent) {
       if (Date.now() - lastOrphanRecoveryAt > ORPHAN_RECOVERY_INTERVAL_MS) {
         lastOrphanRecoveryAt = Date.now();

package/dist/{cli-ma04faw5.js → cli-5arfywtm.js}

@@ -199,6 +199,8 @@ function renderNodeLine(node) {
   let line = `${icon} *${node.agentName}* (${taskLink})`;
   if (node.duration)
     line += ` · ${node.duration}`;
+  if (node.steered)
+    line += " · _steered_";
   return line;
 }
 function renderChildDetail(node, indent) {

package/dist/{cli-m7dmk462.js → cli-822d4bjk.js}

@@ -7,7 +7,7 @@ import {
 import {
   ensureAuthorizationTokenOrThrow,
   oauthAppRowToProviderConfig
-} from "./cli-tc8xk5zh.js";
+} from "./cli-c9m59f83.js";
 import {
   getScript,
   getScriptApiConnectionDescriptors,
@@ -15,15 +15,15 @@ import {
   getScriptVersion,
   listRelationalCredentialBindings,
   validateScriptImports
-} from "./cli-8x745f40.js";
+} from "./cli-p11rf59d.js";
 import {
   getAuthorizationById,
   getOAuthApp,
   getOAuthAppById
-} from "./cli-z3hcrghs.js";
+} from "./cli-9hj1adgp.js";
 import {
   withSiblingAwareness
-} from "./cli-00yr0kxv.js";
+} from "./cli-kmm1rwmp.js";
 import {
   getAppUrl
 } from "./cli-dh55d5fg.js";
@@ -77,7 +77,7 @@ import {
   updateWorkflowRun,
   updateWorkflowRunStep,
   workflowContextKey
-} from "./cli-mjxnr12j.js";
+} from "./cli-8cq4z4x7.js";
 import {
   init_secret_scrubber,
   isSensitiveKey,
@@ -650,8 +650,12 @@ async function runStepValidation(registry, stepNode, stepOutput, context, meta)
 
 // src/workflows/engine.ts
 var DEFAULT_TIMEOUT_MS = 30000;
-var MAX_ITERATIONS = Number(process.env.WORKFLOW_MAX_ITERATIONS) || 100;
-var MAX_STEPS_PER_RUN = Number(process.env.WORKFLOW_MAX_STEPS_PER_RUN) || 500;
+function maxIterations() {
+  return Number(process.env.WORKFLOW_MAX_ITERATIONS) || 100;
+}
+function maxStepsPerRun() {
+  return Number(process.env.WORKFLOW_MAX_STEPS_PER_RUN) || 500;
+}
 
 class TriggerSchemaError extends Error {
   validationErrors;
@@ -736,10 +740,10 @@ async function walkGraph(def, runId, ctx, startNodes, registry, workflowId, secr
     }
   }
   const allSteps = getWorkflowRunStepsByRunId(runId);
-  if (allSteps.length >= MAX_STEPS_PER_RUN) {
+  if (allSteps.length >= maxStepsPerRun()) {
     updateWorkflowRun(runId, {
       status: "failed",
-      error: `Circuit breaker: run exceeded ${MAX_STEPS_PER_RUN} total steps (WORKFLOW_MAX_STEPS_PER_RUN)`,
+      error: `Circuit breaker: run exceeded ${maxStepsPerRun()} total steps (WORKFLOW_MAX_STEPS_PER_RUN)`,
       finishedAt: new Date().toISOString()
     });
     return;
@@ -764,10 +768,10 @@ async function walkGraph(def, runId, ctx, startNodes, registry, workflowId, secr
   const executedInThisWalk = new Set;
   while (pendingNodes.length > 0) {
     nodeExecutionCount += pendingNodes.length;
-    if (nodeExecutionCount > MAX_ITERATIONS) {
+    if (nodeExecutionCount > maxIterations()) {
       updateWorkflowRun(runId, {
         status: "failed",
-        error: `Max node executions (${MAX_ITERATIONS}) exceeded — possible infinite loop`,
+        error: `Max node executions (${maxIterations()}) exceeded — possible infinite loop`,
         finishedAt: new Date().toISOString()
       });
       return;
@@ -2334,7 +2338,7 @@ init_context_key();
 init_types();
 var AgentTaskConfigSchema = exports_external.object({
   template: exports_external.string(),
-  agentId: exports_external.string().uuid().optional(),
+  agentId: exports_external.string().optional(),
   tags: exports_external.array(exports_external.string()).optional(),
   priority: exports_external.number().int().min(0).max(100).optional(),
   offerMode: exports_external.boolean().optional(),
@@ -2623,7 +2627,7 @@ class HumanInTheLoopExecutor extends BaseExecutor {
       }
       if (notification.channel === "slack") {
         try {
-          const { getSlackApp } = await import("./app-knevny0f.js");
+          const { getSlackApp } = await import("./app-vmvmj2v3.js");
           const slackApp = getSlackApp();
           if (!slackApp) {
             console.warn("[HITL] Slack not initialized — cannot send notification");
@@ -2737,7 +2741,7 @@ class NotifyExecutor extends BaseExecutor {
         }
       }
       case "slack": {
-        const { getSlackApp } = await import("./app-knevny0f.js");
+        const { getSlackApp } = await import("./app-vmvmj2v3.js");
         const app = getSlackApp();
         if (!app) {
           return {