@desplega.ai/agent-swarm 1.147.0 → 1.149.0

package/dist/{cli-yz3djrm0.js → cli-6pqcb4q0.js}

@@ -25,7 +25,7 @@ import {
   sandboxSpawnEnv,
   snapshotCapped,
   touchScratchScriptLastUsed
-} from "./cli-3tgwnf43.js";
+} from "./cli-aae6hz6a.js";
 import {
   detachedProcessGroup,
   registerProcessGroup,
@@ -34,17 +34,18 @@ import {
 import {
   getOAuthApp,
   getOAuthTokens
-} from "./cli-zhjmqxzh.js";
+} from "./cli-9hspd3dp.js";
 import {
   withSiblingAwareness
-} from "./cli-53s590z8.js";
+} from "./cli-q50ef8g0.js";
 import {
   getSlackApp
-} from "./cli-b5bq9crk.js";
+} from "./cli-d8ftsp62.js";
 import {
   FollowUpConfigSchema,
   ModelTierSchema,
   ReasoningEffortSchema,
+  RoutingReasonSchema,
   cancelPendingApprovalRequestsForRun,
   cancelTask,
   claimApprovalCancellationNotification,
@@ -91,13 +92,13 @@ import {
   updateWorkflowRun,
   updateWorkflowRunStep,
   workflowContextKey
-} from "./cli-ftht3zzj.js";
+} from "./cli-yab68w40.js";
 import {
   deepInterpolate,
   findInterpolationTokens,
   init_template,
   interpolate
-} from "./cli-kpv03zhj.js";
+} from "./cli-3apbzgyk.js";
 import {
   getAppUrl,
   getMcpBaseUrl,
@@ -113,7 +114,7 @@ import {
   init_secret_scrubber,
   isSensitiveKey,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import {
   init_event_bus,
   workflowEventBus
@@ -121,6 +122,38 @@ import {
 import {
   __require
 } from "./cli-bc05qbss.js";
+// src/automation-preflight-alert.ts
+init_constants();
+init_secret_scrubber();
+async function notifyAutomationPreflightFailure(preflight) {
+  const channel = process.env.SLACK_ALERTS_CHANNEL?.trim();
+  if (!channel) {
+    console.warn("[Automation Preflight] SLACK_ALERTS_CHANNEL not set; skipping alert");
+    return;
+  }
+  try {
+    const { getSlackApp: getSlackApp2 } = await import("./app-1hh67x8w.js");
+    const app = getSlackApp2();
+    if (!app) {
+      console.warn("[Automation Preflight] Slack not available, cannot send notification");
+      return;
+    }
+    await app.client.chat.postMessage({
+      channel,
+      text: scrubSecrets(`⚠️ Automation needs setup
+` + `Automation: ${preflight.kind} "${preflight.name}"
+Missing params: ${preflight.missing.params.join(", ") || "none"}
+Missing integrations: ${preflight.missing.integrations.join(", ") || "none"}
+Fire SKIPPED. It was not retried or queued.
+Fix setup: ${getAppUrl()}${preflight.fixUrl}`),
+      unfurl_links: false,
+      unfurl_media: false
+    });
+  } catch (error) {
+    console.error("[Automation Preflight] Failed to send Slack notification:", scrubSecrets(error instanceof Error ? error.message : String(error)));
+  }
+}
+
 // src/be/automation-preflight.ts
 init_db();
 var NEEDS_SETUP_PREFIX = "needs_setup:";
@@ -359,7 +392,7 @@ async function recordWorkflowPreflightFailure(input) {
          AND startedAt >= ? AND startedAt < ?
        ORDER BY startedAt ASC LIMIT 1`, [input.workflowId, bounds.start, bounds.end]);
     if (existing)
-      return existing.id;
+      return { runId: existing.id, recorded: false };
     const runId = crypto.randomUUID();
     const timestamp = now.toISOString();
     await tx.run(`INSERT INTO workflow_runs
@@ -376,7 +409,7 @@ async function recordWorkflowPreflightFailure(input) {
       timestamp,
       timestamp
     ]);
-    return runId;
+    return { runId, recorded: true };
   });
 }
 
@@ -876,13 +909,16 @@ async function resolveRenderedWorkflowInputs(input) {
 async function startWorkflowExecution(workflow, triggerData, registry, options = {}) {
   const preflight = preflightAutomation(workflowPreflightInput(workflow), await getAutomationSetupStates());
   if (preflight.state === "needs_setup") {
-    return await recordWorkflowPreflightFailure({
+    const { runId: runId2, recorded } = await recordWorkflowPreflightFailure({
       workflowId: workflow.id,
       triggerType: options.triggerType ?? "manual",
       triggerData,
       failureReason: preflight.failureReason,
       createdBy: options.requestedByUserId
     });
+    if (recorded)
+      await notifyAutomationPreflightFailure(preflight);
+    return runId2;
   }
   workflow = renderAutomationTokens(workflow, workflow.params ?? {});
   if (workflow.triggerSchema) {
@@ -2882,6 +2918,8 @@ init_types();
 var AgentTaskConfigSchema = exports_external.object({
   template: exports_external.string(),
   agentId: exports_external.string().optional(),
+  routingReason: RoutingReasonSchema.optional(),
+  routingNote: exports_external.string().max(200).optional(),
   tags: exports_external.array(exports_external.string()).optional(),
   priority: exports_external.number().int().min(0).max(100).optional(),
   offerMode: exports_external.boolean().optional(),
@@ -2941,6 +2979,8 @@ class AgentTaskExecutor extends BaseExecutor {
     const { description: taskDescription, options: taskOptions } = await withSiblingAwareness(config.template, {
       key: effectiveKey,
       agentId: config.agentId ?? null,
+      routingReason: config.routingReason ?? (config.agentId ? "human_pinned" : undefined),
+      routingNote: config.routingNote,
       source: "workflow",
       tags: config.tags,
       priority: config.priority,
@@ -3335,7 +3375,7 @@ class HumanInTheLoopExecutor extends BaseExecutor {
       }
       if (notification.channel === "slack") {
         try {
-          const { getSlackApp: getSlackApp2 } = await import("./app-w066xfy0.js");
+          const { getSlackApp: getSlackApp2 } = await import("./app-1hh67x8w.js");
           const slackApp = getSlackApp2();
           if (!slackApp) {
             console.warn("[HITL] Slack not initialized — cannot send notification");
@@ -3455,7 +3495,7 @@ class NotifyExecutor extends BaseExecutor {
         }
       }
       case "slack": {
-        const { getSlackApp: getSlackApp2 } = await import("./app-w066xfy0.js");
+        const { getSlackApp: getSlackApp2 } = await import("./app-1hh67x8w.js");
         const app = getSlackApp2();
         if (!app) {
           return {
@@ -4279,4 +4319,4 @@ async function initWorkflows() {
   logOpenWebhookTriggers();
 }
 
-export { validateJsonSchema, findJsonSchemaShapeErrors, automationIntegrationFixUrl, isNeedsSetupFailure, preflightAutomation, renderAutomationTokens, getAutomationSetupStates, schedulePreflightInput, listEnabledAutomationPreflightInputs, recordSchedulePreflightFailure, TriggerSchemaError, startWorkflowExecution, setupWorkflowResumeListener, retryFailedRun, cancelWorkflowRun, resumeWaitState, initWaitBusSubscriptions, subscribeWaitToBus, recoverIncompleteRuns, startRetryPoller, stopRetryPoller, validateTemplateVariables, instantiateTemplate, handleWebhookTrigger, logOpenWebhookTriggers, handleEventTrigger, handleScheduleTrigger, verifyHmacSignature, WebhookError, snapshotWorkflow, snapshotAndUpdateWorkflow, startWaitPoller, stopWaitPoller, RawLlmConfigSchema, RawLlmOutputSchema, executeRawLlm, getExecutorRegistry, initWorkflows };
+export { validateJsonSchema, findJsonSchemaShapeErrors, notifyAutomationPreflightFailure, automationIntegrationFixUrl, isNeedsSetupFailure, preflightAutomation, renderAutomationTokens, getAutomationSetupStates, schedulePreflightInput, listEnabledAutomationPreflightInputs, recordSchedulePreflightFailure, TriggerSchemaError, startWorkflowExecution, setupWorkflowResumeListener, retryFailedRun, cancelWorkflowRun, resumeWaitState, initWaitBusSubscriptions, subscribeWaitToBus, recoverIncompleteRuns, startRetryPoller, stopRetryPoller, validateTemplateVariables, instantiateTemplate, handleWebhookTrigger, logOpenWebhookTriggers, handleEventTrigger, handleScheduleTrigger, verifyHmacSignature, WebhookError, snapshotWorkflow, snapshotAndUpdateWorkflow, startWaitPoller, stopWaitPoller, RawLlmConfigSchema, RawLlmOutputSchema, executeRawLlm, getExecutorRegistry, initWorkflows };

package/dist/{cli-719k9j2c.js → cli-7smrsr25.js}

@@ -1,6 +1,6 @@
 import {
   runStopHookSessionSummarySubprocess
-} from "./cli-89xfd7f9.js";
+} from "./cli-cr12paw2.js";
 import {
   SessionErrorTracker,
   buildOtelTraceparentEnv,
@@ -42,7 +42,7 @@ import {
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import {
   require_src
 } from "./cli-knd276ed.js";
@@ -817,7 +817,7 @@ class ClaudeAdapter {
     if (transport === "sdk" && isClaudeBridgeEffective(sourceEnv)) {
       throw new Error("CLAUDE_TRANSPORT=sdk cannot run with an effective Claude Bridge configuration. Select CLI transport or disable the bridge.");
     }
-    const claudeSdk = transport === "sdk" ? await import("./claude-sdk-session-f0cc1kec.js") : undefined;
+    const claudeSdk = transport === "sdk" ? await import("./claude-sdk-session-2yxgjs5d.js") : undefined;
     claudeSdk?.validateClaudeSdkAdditionalArgs([
       ...claudeBinaryArgv.slice(1),
       ...config.additionalArgs ?? []

package/dist/{cli-rw51bq3j.js → cli-9fy6nk6g.js}

@@ -1,7 +1,7 @@
 import {
   getDb,
   init_db
-} from "./cli-ftht3zzj.js";
+} from "./cli-yab68w40.js";
 
 // src/be/seed-pricing.ts
 init_db();

package/dist/{cli-zhjmqxzh.js → cli-9hspd3dp.js}

@@ -7,12 +7,12 @@ import {
   init_date_utils,
   init_db,
   normalizeDateRequired
-} from "./cli-ftht3zzj.js";
+} from "./cli-yab68w40.js";
 import {
   init_secret_scrubber,
   registerVolatileSecret,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 
 // src/be/db-queries/oauth.ts
 init_crypto();

package/dist/{cli-3tgwnf43.js → cli-aae6hz6a.js}

@@ -3,7 +3,7 @@ import {
 } from "./cli-epan13p1.js";
 import {
   embedScript
-} from "./cli-hbv0kq6w.js";
+} from "./cli-2qts1hys.js";
 import {
   detachedProcessGroup,
   registerProcessGroup,
@@ -23,7 +23,7 @@ import {
   oauthAppRowToProviderConfig,
   updateAuthorizationTokens,
   upsertAuthorization
-} from "./cli-zhjmqxzh.js";
+} from "./cli-9hspd3dp.js";
 import {
   CredentialBroker,
   DEFAULT_CREDENTIAL_BINDINGS,
@@ -44,7 +44,7 @@ import {
   normalizeDateRequired,
   placeholderForConfigKey,
   upsertSwarmConfig
-} from "./cli-ftht3zzj.js";
+} from "./cli-yab68w40.js";
 import {
   init_env_flag,
   isEnvFlagEnabled
@@ -61,7 +61,7 @@ import {
   registerVolatileSecret,
   scrubObject,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import {
   __commonJS,
   __require,

package/dist/{cli-89xfd7f9.js → cli-cr12paw2.js}

@@ -1,10 +1,10 @@
 import {
   materializeClaudeMd,
   stopClaudeMd
-} from "./cli-d8brzxjb.js";
+} from "./cli-4wtq5jjv.js";
 import {
   summarizeSession
-} from "./cli-rvqz34y5.js";
+} from "./cli-jecc01cb.js";
 import {
   checkToolLoop,
   clearToolHistory
@@ -26,7 +26,7 @@ import {
   init_profile_sync,
   readIdentityBaselines,
   warnProfileFileTooLarge
-} from "./cli-m9sxbkhm.js";
+} from "./cli-zvz62chv.js";
 import {
   MAX_PROFILE_FILE_LENGTH,
   getMcpBaseUrl,
@@ -35,11 +35,11 @@ import {
 import {
   init_package,
   package_default
-} from "./cli-w9kb3bk1.js";
+} from "./cli-kjwt6hdf.js";
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 
 // src/hooks/hook.ts
 init_package();

package/dist/{cli-b5bq9crk.js → cli-d8ftsp62.js}

@@ -49,7 +49,7 @@ import {
   setSlackMessageTracking,
   slackContextKey,
   updateSlackMessageRecord
-} from "./cli-ftht3zzj.js";
+} from "./cli-yab68w40.js";
 import {
   getAppUrl,
   init_constants
@@ -61,7 +61,7 @@ import {
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import {
   require_extension,
   require_permessage_deflate,
@@ -54475,7 +54475,7 @@ async function initOtel(serviceRole = process.env.AGENT_ROLE || "api") {
     return;
   initialized = true;
   try {
-    const impl = await import("./otel-impl-0w7c14ap.js");
+    const impl = await import("./otel-impl-tbk3e5dr.js");
     await impl.boot(serviceRole);
     realWithSpan = impl.withSpan;
     realStartSpan = impl.startSpan;
@@ -55793,13 +55793,13 @@ async function initSlackApp() {
     logLevel: import_bolt.LogLevel.DEBUG,
     ...slackApiUrl ? { clientOptions: { slackApiUrl } } : {}
   });
-  const { registerMessageHandler } = await import("./handlers-0aspcejm.js");
-  const { registerCommandHandler } = await import("./commands-sykrxx7e.js");
-  const { registerActionHandlers } = await import("./actions-2vxqvpr9.js");
+  const { registerMessageHandler } = await import("./handlers-nbzdzn9k.js");
+  const { registerCommandHandler } = await import("./commands-hz3nb95f.js");
+  const { registerActionHandlers } = await import("./actions-31vp3ae7.js");
   registerMessageHandler(app);
   registerCommandHandler(app);
   registerActionHandlers(app);
-  const { createAssistant } = await import("./assistant-kt31dj2h.js");
+  const { createAssistant } = await import("./assistant-z66dmz6p.js");
   app.assistant(createAssistant());
   return app;
 }
@@ -55808,7 +55808,7 @@ async function startSlackApp() {
     await initSlackApp();
   }
   if (app) {
-    const { isSlackRenderV2Enabled: isSlackRenderV2Enabled2 } = await import("./render-v2-vbr89fnb.js");
+    const { isSlackRenderV2Enabled: isSlackRenderV2Enabled2 } = await import("./render-v2-80w603vy.js");
     if (isSlackRenderV2Enabled2())
       await ensureSlackRenderV2Activation();
     await app.start();

package/dist/{cli-4nr988h6.js → cli-e95cx1eb.js}

@@ -13,7 +13,7 @@ import {
 } from "./cli-b5b30yzk.js";
 import {
   summarizeSession
-} from "./cli-rvqz34y5.js";
+} from "./cli-jecc01cb.js";
 import {
   CTX_MODE_NUDGE_EVERY
 } from "./cli-zm7njwzd.js";
@@ -49,11 +49,11 @@ import {
 import {
   init_package,
   package_default
-} from "./cli-w9kb3bk1.js";
+} from "./cli-kjwt6hdf.js";
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import {
   __require
 } from "./cli-bc05qbss.js";

package/dist/{cli-n8508nre.js → cli-gjhjfeeg.js}

@@ -1,7 +1,7 @@
 import {
   init_package,
   package_default
-} from "./cli-w9kb3bk1.js";
+} from "./cli-kjwt6hdf.js";
 
 // src/commands/shared/client-config.ts
 init_package();

package/dist/{cli-p1d5b073.js → cli-gv88e1vf.js}

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

package/dist/{cli-rvqz34y5.js → cli-jecc01cb.js}

@@ -23,7 +23,7 @@ import {
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 
 // src/utils/internal-ai/complete-structured.ts
 init_zod();

package/dist/{cli-8v0g1yc8.js → cli-k0cr4kat.js}

@@ -5,7 +5,7 @@ import {
   getDb,
   getDbClient,
   init_db
-} from "./cli-ftht3zzj.js";
+} from "./cli-yab68w40.js";
 
 // src/be/rbac-roles.ts
 init_db();

package/dist/{cli-mmemxxdc.js → cli-kgz4np97.js}

@@ -4,7 +4,7 @@ import {
 } from "./cli-jsp14b6c.js";
 import {
   createTaskWithSiblingAwareness
-} from "./cli-53s590z8.js";
+} from "./cli-q50ef8g0.js";
 import {
   init_task_attachment_links,
   taskAttachmentFetchCommand
@@ -19,13 +19,13 @@ import {
   insertTaskAttachment,
   promoteDraftTask,
   refreshDraftTaskLease
-} from "./cli-ftht3zzj.js";
+} from "./cli-yab68w40.js";
 import {
   init_registry,
   init_resolver,
   registerTemplate,
   resolveTemplate
-} from "./cli-kpv03zhj.js";
+} from "./cli-3apbzgyk.js";
 import {
   init_env_flag,
   isEnvFlagEnabled
@@ -33,7 +33,7 @@ import {
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import {
   __callDispose,
   __using

package/dist/{cli-w9kb3bk1.js → cli-kjwt6hdf.js}

@@ -7,7 +7,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@desplega.ai/agent-swarm",
-    version: "1.147.0",
+    version: "1.149.0",
     description: "agent-swarm.dev — an open-source operating system for AI work: a lead agent breaks goals into tasks, routes them to specialized workers such as Claude Code or Codex, runs each worker in an isolated container, and preserves shared memory, tools, schedules, and review gates so delegated work compounds across sessions.",
     keywords: [
       "agent-swarm.dev",
@@ -118,6 +118,8 @@ var init_package = __esm(() => {
       "prepare-release": "bun scripts/prepare-release.ts",
       "refresh:vendored-openapi": "bun scripts/refresh-vendored-openapi.ts",
       "sync-chart-version": "bun scripts/sync-chart-version.ts",
+      "sync-plugin-versions": "bun scripts/sync-plugin-versions.ts",
+      "check:plugin-versions": "bun scripts/sync-plugin-versions.ts --check",
       "bump:agent-fs": "bun scripts/bump-agent-fs.ts",
       "check-chart-version": "bun scripts/sync-chart-version.ts --check-if-package-version-changed",
       cli: "bun src/cli.tsx",

package/dist/{cli-f7dsy61y.js → cli-mnmsfd1w.js}

@@ -26,11 +26,11 @@ import {
   updateAgentMaxTasks,
   updateAgentStatus,
   upsertSwarmConfig
-} from "./cli-ftht3zzj.js";
+} from "./cli-yab68w40.js";
 import {
   init_resolver,
   resolveTemplate
-} from "./cli-kpv03zhj.js";
+} from "./cli-3apbzgyk.js";
 import {
   init_env_flag,
   isEnvFlagEnabled
@@ -478,6 +478,7 @@ ${depLines.join(`
   }
   return await createTaskExtended(followUpDescription, {
     agentId: leadAgent.id,
+    routingReason: "skill",
     source: "system",
     taskType: "follow-up",
     parentTaskId: task.id,
@@ -555,6 +556,7 @@ async function createResumeFollowUp(args) {
   } : sourceAffinity;
   const created = await createTaskExtended(followUpDescription, {
     agentId: preferredAgentId,
+    routingReason: preferredAgentId === undefined ? undefined : preferredAgentId === parent.agentId ? "continuity" : "reroute_fault",
     creatorAgentId: parent.creatorAgentId,
     source: "system",
     taskType: "resume",
@@ -608,6 +610,7 @@ async function createRerouteDecisionTask(args) {
   });
   const created = await createTaskExtended(decision.text, {
     agentId: leadAgent.id,
+    routingReason: "reroute_fault",
     creatorAgentId: original.creatorAgentId,
     source: "system",
     taskType: "reroute-decision",
@@ -644,6 +647,7 @@ async function createPoolStarvationDecisionTask(args) {
   });
   const created = await createTaskExtended(decision.text, {
     agentId: leadAgent.id,
+    routingReason: "overflow",
     creatorAgentId: original.creatorAgentId,
     source: "system",
     taskType: "reroute-decision",

package/dist/{cli-54wwve05.js → cli-n3dz2942.js}

@@ -1,12 +1,12 @@
 import {
   SYSTEM_COLUMN_KINDS,
   listAppRecords
-} from "./cli-de14znh8.js";
+} from "./cli-19f354qr.js";
 import {
   getScriptApiTypes,
   getScriptMcpTypes,
   require_typescript
-} from "./cli-3tgwnf43.js";
+} from "./cli-aae6hz6a.js";
 import {
   deleteSwarmConfigByKey,
   getAgentById,
@@ -15,11 +15,11 @@ import {
   getSwarmConfigs,
   init_db,
   upsertSwarmConfig
-} from "./cli-ftht3zzj.js";
+} from "./cli-yab68w40.js";
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import {
   __require,
   __toESM
@@ -629,6 +629,36 @@ export type ScriptScope = "agent" | "global";
 export type ScriptFsMode = "none" | "workspace-rw";
 export type ScriptApiRawOptions = { raw: true };
 export type ScriptApiDefaultOptions = { raw?: false };
+export type RoutingReason = "skill" | "continuity" | "overflow" | "human_pinned" | "reroute_fault";
+export type TaskSendArgs = Record<string, unknown> & {
+  task: string;
+  routingNote?: string;
+} & (
+  | { agentId: string; routingReason: RoutingReason }
+  | { agentId?: never; routingReason?: never }
+);
+export type AgentTaskStepConfig = {
+  template?: string;
+  task?: string;
+  agentId?: string;
+  routingReason?: RoutingReason;
+  routingNote?: string;
+  tags?: string[];
+  priority?: number;
+  offerMode?: boolean;
+  dir?: string;
+  vcsRepo?: string;
+  model?: string;
+  parentTaskId?: string;
+  requestedByUserId?: string;
+  outputSchema?: Record<string, unknown>;
+  /** Wait for the dispatched task to reach a terminal status before resolving. Default: true. */
+  waitForCompletion?: boolean;
+  /** Max ms to wait for a terminal status before throwing. Default: 2h. Only used when waitForCompletion is true. */
+  timeoutMs?: number;
+  /** Throw when the task ends failed/cancelled/superseded (default), or resolve with {taskId,status,error} when false. */
+  failOnTaskFailure?: boolean;
+};
 
 export interface ScriptApiRawResult {
   ok: boolean;
@@ -732,7 +762,7 @@ export interface SwarmSdk {
   task_list(args?: Record<string, unknown>): Promise<unknown>;
   task_get(args: { taskId: string }): Promise<unknown>;
   task_storeProgress(args: Record<string, unknown>): Promise<unknown>;
-  task_defer(args: { taskId: string; delayMs?: number; runAt?: string; summary: string; note: string; checks?: string[] }): Promise<unknown>;
+  task_defer(args: { taskId: string; delayMs?: number; runAt?: string; wakeOn?: { event: "task.completed" | "task.failed" | "settled"; taskId: string }; summary: string; note: string; checks?: string[] }): Promise<unknown>;
   task_poll(args?: Record<string, unknown>): Promise<unknown>;
   // --- kv ---
   kv_get<T = unknown>(args: { key: string; namespace?: string }): Promise<KvSdkResponse<KvEntry<T>>>;
@@ -813,7 +843,7 @@ export interface SwarmSdk {
   inject_learning(args: { content: string; name?: string; scope?: "agent" | "swarm"; source?: string; tags?: string[] }): Promise<unknown>;
 
   // --- write: tasks ---
-  task_send(args: Record<string, unknown>): Promise<unknown>;
+  task_send(args: TaskSendArgs): Promise<unknown>;
   task_cancel(args: { taskId: string }): Promise<unknown>;
   task_steer(args: { taskId: string; message: string; mode?: "steer" | "queue"; onUnsupported?: "degrade" | "fail" }): Promise<unknown>;
   task_action(args: Record<string, unknown>): Promise<unknown>;
@@ -968,26 +998,7 @@ export interface ScriptWorkflowSteps {
   ): Promise<unknown>;
   agentTask(
     label: string,
-    config: {
-      template?: string;
-      task?: string;
-      agentId?: string;
-      tags?: string[];
-      priority?: number;
-      offerMode?: boolean;
-      dir?: string;
-      vcsRepo?: string;
-      model?: string;
-      parentTaskId?: string;
-      requestedByUserId?: string;
-      outputSchema?: Record<string, unknown>;
-      /** Wait for the dispatched task to reach a terminal status before resolving. Default: true. */
-      waitForCompletion?: boolean;
-      /** Max ms to wait for a terminal status before throwing. Default: 2h. Only used when waitForCompletion is true. */
-      timeoutMs?: number;
-      /** Throw when the task ends failed/cancelled/superseded (default), or resolve with {taskId,status,error} when false. */
-      failOnTaskFailure?: boolean;
-    },
+    config: AgentTaskStepConfig,
   ): Promise<unknown>;
   swarmScript(
     label: string,