Skip to content

Tools

Agent Swarm fixes child workflows that survived cancellation

3-line summary

  1. Agent Swarm 2.5.4 fixes cancellation across child workflows that previously stayed active.
  2. Optional request keys replay the original create or trigger result after a retry.
  3. Deployment-interrupted items default to one retry after 30 seconds.
PracticalDevelopers
A disconnected red lever beside three branching metal linkages and still wheels
AI-generated concept of cancelling branched work, not a product photograph · AI Ping

desplega.ai released Agent Swarm 2.5.4 on October 25, fixing child workflows that remained active after their parent was cancelled. The release also adds duplicate-request protection when creating or starting workflows and repairs retries for parallel agent tasks interrupted during deployment.

Agent Swarm is an open-source system in which a lead agent delegates goals to workers such as Claude Code or Codex. Workers use isolated containers, shared memory, schedules and review gates. Work can arrive through Slack, repositories, issue trackers, email or an API, then be distributed across the team. Memory and agent identity persist across sessions, and the dashboard provides task logs and file attachments. Workflows, schedules, scripts and apps support recurring work.

Cancellation now follows stored parent-child links through the descendant runs, clearing open tasks, unfinished steps, pending approvals and queued retries. Guards block new engine work and late callbacks after cancellation. Completed descendants retain their status and output. Repeating cancellation can clean up children that an older release left active.

This guarantee concerns database state. It does not immediately kill an already-running script or model call; an agent session can continue until its worker observes the cancelled task. External changes already made are not rolled back. The project includes regression cases for child creation around cancellation and children that finish late.

An optional Idempotency-Key header lets create and trigger HTTP requests replay their original response after a timeout. Keys are scoped by caller, operation and target workflow. Requests without a key behave as before.

The same key with different content returns 409; replay after workflow deletion returns 410. Accepted keys never expire. External actions inside steps are not made exactly-once. The change record says Script SDK and MCP create and trigger tools do not yet send keys.

Two matching amber tokens beside a single paper strip
AI-generated concept: matching requests receive an existing result · AI Ping

The release also fixes foreach agent-task items interrupted during deployment. Previously, item identifiers escaped the retry lookup and entered the aggregate as failures. The matching interruption now gets one default retry after 30 seconds, dispatched as a fresh task.

A retry awaiting dispatch keeps its concurrency slot and prevents the join from treating the item as settled. An explicit parent retry policy overrides the default; maxRetries set to zero disables it. Other failures retain their existing policy. Retries cannot revive failed or cancelled runs.

Interruption, 30-second wait, one retry
Diagram: default deploy-interruption retry · AI Ping

Version 2.5.4 is listed for npm, Bun and Docker deployments of the server, workers and dashboard. GitHub dates the release to October 25 at 02:52:48 UTC; the fixes were merged on October 24.

Sources

  • How-to guideAbout 17 min reading

    Design an AI workflow with clear review points

    Map intake, drafting, review and approval. Walk through missing information and retries on paper, with explicit stop and handoff conditions.

    AdvancedPlanningDesignersMarketersSalesProduct researchOffice workersDevelopers
  • How-to guideAbout 18 min reading

    Evaluate AI work beyond first impressions

    Build a small evaluation set, compare drafts against evidence, change one instruction and test on a fresh case. No code required.

    AdvancedPlanningDesignersMarketersSalesProduct researchOffice workersDevelopers