@desplega.ai/agent-swarm 2.6.0 → 2.7.0

package/dist/{session-access-fdhp987s.js → session-access-r5garej6.js}

@@ -10,10 +10,10 @@ import {
   pathSessionDenial2,
   bodySessionDenial2,
   userAgentIdentityDenial2
-} from "./cli-art7c1zh.js";
-import"./cli-esakngh8.js";
-import"./cli-a2rr0fmg.js";
-import"./cli-g8ka5j4j.js";
+} from "./cli-wqr7cea4.js";
+import"./cli-a89zdqz9.js";
+import"./cli-8wmj18cz.js";
+import"./cli-48gxjmcz.js";
 export {
   SESSION_READ_DENIED2 as SESSION_READ_DENIED,
   SESSION_WRITE_DENIED2 as SESSION_WRITE_DENIED,

package/dist/{session-source-backfill-qgtc86z1.js → session-source-backfill-424wzv0r.js}

@@ -7,12 +7,12 @@ import {
   moveTaskChainKeyInTx2,
   init_session_moves,
   init_db3
-} from "./cli-g8ka5j4j.js";
+} from "./cli-48gxjmcz.js";
 import {
   normalizeAssetKey,
   defaultAssetKey,
   init_key
-} from "./cli-4rf0f5vg.js";
+} from "./cli-9pshx6rd.js";
 import {
   scrubSecrets,
   init_secret_scrubber

package/dist/{setup-4rrmqcq3.js → setup-8tygvxkq.js}

@@ -15,7 +15,7 @@ import {
   createDefaultSettingsLocal,
   createDefaultMcpJson,
   createHooksConfig
-} from "./cli-abkm71vr.js";
+} from "./cli-a6ds2epe.js";
 import {
   getApiKey,
   init_api_key

package/dist/{virtual-modules-52km00d6.js → virtual-modules-xsw323b3.js}

@@ -4,7 +4,7 @@ import {
   exports_compile,
   exports_all,
   exports_compat
-} from "./cli-v49fkghp.js";
+} from "./cli-1m9x8dr5.js";
 import {
   exports_models
 } from "./cli-2nf3b08t.js";
@@ -14,7 +14,7 @@ import {
   exports_dist,
   exports_dist2,
   exports_dist3
-} from "./cli-w2656ka1.js";
+} from "./cli-2y7v133v.js";
 import"./cli-13p25grh.js";
 import"./cli-0adyhvq2.js";
 import"./cli-rycdaj0a.js";

package/dist/{work-objects-p28fgd70.js → work-objects-ggnghpgf.js}

@@ -2,46 +2,46 @@ import {
   getAgentById2,
   getTaskById2,
   init_db3
-} from "./cli-g8ka5j4j.js";
+} from "./cli-48gxjmcz.js";
 import {
   slackTaskOutput,
   getTaskUrl
-} from "./cli-g20jjwt4.js";
+} from "./cli-m30k9777.js";
 import {
   shouldBlockChannel2
-} from "./cli-gnsb1zxa.js";
-import"./cli-4hxrf0p4.js";
-import"./cli-3fwqy71j.js";
-import"./cli-3gfvmzht.js";
-import"./cli-kf4jree9.js";
+} from "./cli-s09j9vp5.js";
+import"./cli-6a9qfa8b.js";
+import"./cli-j0ppywdr.js";
+import"./cli-j9bpmykh.js";
+import"./cli-aypd09nf.js";
 import"./cli-3ggwdtb0.js";
 import"./cli-e8xyjvfc.js";
-import"./cli-v49fkghp.js";
+import"./cli-1m9x8dr5.js";
 import"./cli-2nf3b08t.js";
 import"./cli-kvzgak7c.js";
 import"./cli-445c1vp7.js";
 import"./cli-0z1xjzwa.js";
 import"./cli-kt907da6.js";
-import"./cli-3aqd4jaa.js";
-import"./cli-bqztfyve.js";
-import"./cli-5sckpqcx.js";
-import"./cli-aj8djyqt.js";
+import"./cli-twctnkng.js";
+import"./cli-8mbc9za9.js";
+import"./cli-d20qvpr2.js";
+import"./cli-60sty27p.js";
 import"./cli-qz93y3x5.js";
-import"./cli-a2rr0fmg.js";
-import"./cli-03gg9pd1.js";
+import"./cli-8wmj18cz.js";
+import"./cli-rd5m70gj.js";
 import"./cli-g9ypd5en.js";
-import"./cli-gf95q3bm.js";
-import"./cli-art7c1zh.js";
+import"./cli-6srv653c.js";
+import"./cli-wqr7cea4.js";
 import"./cli-3h26v7yj.js";
 import"./cli-737pyqxr.js";
-import"./cli-24j1jeeb.js";
-import"./cli-sqma6vw1.js";
+import"./cli-2pvzmas1.js";
+import"./cli-sgqm2582.js";
 import {
   isUserAllowed2
-} from "./cli-mvjz5an3.js";
+} from "./cli-f4dbh7a5.js";
 import"./cli-13p25grh.js";
 import"./cli-0adyhvq2.js";
-import"./cli-esakngh8.js";
+import"./cli-a89zdqz9.js";
 import"./cli-rycdaj0a.js";
 import {
   isEnvFlagEnabled,

package/dist/{worker-e3w7vye1.js → worker-sqjd1nqf.js}

@@ -1,67 +1,67 @@
 import"./cli-qz93y3x5.js";
 import {
   getEnabledCapabilities
-} from "./cli-4hxrf0p4.js";
-import"./cli-g8ka5j4j.js";
-import"./cli-a2rr0fmg.js";
-import"./cli-03gg9pd1.js";
-import"./cli-5sckpqcx.js";
-import"./cli-aj8djyqt.js";
-import"./cli-bqztfyve.js";
+} from "./cli-6a9qfa8b.js";
+import"./cli-48gxjmcz.js";
+import"./cli-8wmj18cz.js";
+import"./cli-rd5m70gj.js";
+import"./cli-d20qvpr2.js";
+import"./cli-60sty27p.js";
+import"./cli-8mbc9za9.js";
 import"./cli-kt907da6.js";
-import"./cli-3fwqy71j.js";
-import"./cli-3gfvmzht.js";
-import"./cli-kf4jree9.js";
+import"./cli-j0ppywdr.js";
+import"./cli-j9bpmykh.js";
+import"./cli-aypd09nf.js";
 import"./cli-3ggwdtb0.js";
 import"./cli-e8xyjvfc.js";
-import"./cli-g20jjwt4.js";
-import"./cli-gnsb1zxa.js";
-import"./cli-v49fkghp.js";
+import"./cli-m30k9777.js";
+import"./cli-s09j9vp5.js";
+import"./cli-1m9x8dr5.js";
 import"./cli-2nf3b08t.js";
 import"./cli-kvzgak7c.js";
 import"./cli-445c1vp7.js";
 import"./cli-0z1xjzwa.js";
-import"./cli-3aqd4jaa.js";
-import"./cli-art7c1zh.js";
+import"./cli-twctnkng.js";
+import"./cli-wqr7cea4.js";
 import"./cli-g9ypd5en.js";
-import"./cli-gf95q3bm.js";
+import"./cli-6srv653c.js";
 import"./cli-3h26v7yj.js";
 import"./cli-737pyqxr.js";
-import"./cli-sxgtf5fw.js";
+import"./cli-07q03xm2.js";
 import"./cli-c081bj3b.js";
 import"./cli-77cd6gy8.js";
-import"./cli-n7asmce6.js";
+import"./cli-6mgdba42.js";
 import {
   runAgent
-} from "./cli-5rj83bam.js";
-import"./cli-7enjwya9.js";
+} from "./cli-j3y0x2n4.js";
+import"./cli-vz78s5wm.js";
 import"./cli-yvy48785.js";
-import"./cli-nq677csy.js";
+import"./cli-sjctjr48.js";
 import"./cli-jc1g9ndz.js";
-import"./cli-m5a9m0ak.js";
-import"./cli-2sjhpsns.js";
-import"./cli-ag2yrnt5.js";
+import"./cli-kv7sbc2c.js";
+import"./cli-54sj64fc.js";
+import"./cli-c668vvcf.js";
 import"./cli-d82btycs.js";
 import"./cli-0726awxw.js";
-import"./cli-mtnj4fwa.js";
-import"./cli-k21gx5ht.js";
+import"./cli-yxbsmx56.js";
+import"./cli-1hhbzkbb.js";
 import"./cli-4bd1rck6.js";
 import"./cli-vbhgkw9h.js";
 import"./cli-rr7zx19j.js";
-import"./cli-ffvsj2qw.js";
+import"./cli-yd2nreqw.js";
 import"./cli-kr5tjjtz.js";
-import"./cli-ca6banwz.js";
-import"./cli-cz37jqss.js";
+import"./cli-ymjpkxgn.js";
+import"./cli-h5jeg46p.js";
 import"./cli-39rrw8yp.js";
-import"./cli-az25fn5f.js";
-import"./cli-zqne1qcj.js";
-import"./cli-a34pr3w1.js";
-import"./cli-9abdgn5t.js";
-import"./cli-m70bajzr.js";
+import"./cli-gsfk58nw.js";
+import"./cli-s0mgx214.js";
+import"./cli-e1595bgx.js";
+import"./cli-86ehn4s5.js";
+import"./cli-f12mr20z.js";
 import"./cli-4zsenjhy.js";
 import"./cli-13p25grh.js";
 import"./cli-0adyhvq2.js";
-import"./cli-esakngh8.js";
+import"./cli-a89zdqz9.js";
 import"./cli-rycdaj0a.js";
 
 // src/commands/worker.ts

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "2.6.0",
+    "version": "2.7.0",
     "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": [
@@ -19601,6 +19601,14 @@
             "required": false,
             "name": "model",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": false,
+            "name": "keySuffixes",
+            "in": "query"
           }
         ],
         "responses": {
@@ -54036,6 +54044,17 @@
                       "workspace-rw"
                     ],
                     "default": "none"
+                  },
+                  "executor": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "enum": [
+                      "native",
+                      "quickjs",
+                      null
+                    ]
                   }
                 },
                 "required": [
@@ -54163,6 +54182,17 @@
                     ],
                     "default": "none"
                   },
+                  "executor": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "enum": [
+                      "native",
+                      "quickjs",
+                      null
+                    ]
+                  },
                   "idempotencyKey": {
                     "type": "string",
                     "maxLength": 200
@@ -54749,6 +54779,18 @@
                               "workspace-rw"
                             ]
                           },
+                          "executor": {
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "enum": [
+                              "native",
+                              "quickjs",
+                              null
+                            ],
+                            "default": null
+                          },
                           "createdByAgentId": {
                             "type": [
                               "string",
@@ -54924,6 +54966,18 @@
                             "workspace-rw"
                           ]
                         },
+                        "executor": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "enum": [
+                            "native",
+                            "quickjs",
+                            null
+                          ],
+                          "default": null
+                        },
                         "createdByAgentId": {
                           "type": [
                             "string",
@@ -63521,6 +63575,20 @@
             "name": "id",
             "in": "path"
           },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "true",
+                "false"
+              ],
+              "description": "Default true: respond after the run's instant steps ran, when it finishes or parks at its first async step. false: respond as soon as the run is committed and walk it in the background."
+            },
+            "required": false,
+            "description": "Default true: respond after the run's instant steps ran, when it finishes or parks at its first async step. false: respond as soon as the run is committed and walk it in the background.",
+            "name": "wait",
+            "in": "query"
+          },
           {
             "schema": {
               "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "2.6.0",
+  "version": "2.7.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",
@@ -80,6 +80,8 @@
     "sync:ai-toolbox-skills": "bun scripts/sync-ai-toolbox-skills.ts",
     "check:ai-toolbox-skills": "bun scripts/sync-ai-toolbox-skills.ts --check",
     "check:skill-sources": "bun scripts/check-skill-sources.ts",
+    "build:docs-index": "bun scripts/build-docs-index.ts",
+    "check:docs-index": "bun scripts/build-docs-index.ts --check",
     "check:operator-skill": "bun scripts/check-operator-skill.ts",
     "sync:telemetry-contract": "bun scripts/sync-telemetry-contract.ts",
     "check:telemetry-contract": "bun scripts/sync-telemetry-contract.ts --check",
@@ -185,7 +187,7 @@
     "@oxlint/plugins": "1.78.0",
     "@types/bun": "latest",
     "dependency-cruiser": "^18.0.0",
-    "happy-dom": "^20.14.5",
+    "happy-dom": "^21.0.4",
     "konsistent": "1.0.0-beta.1",
     "openapi-typescript": "^7",
     "oxlint": "1.78.0",
@@ -210,7 +212,7 @@
     "@chat-adapter/teams": "4.41.1",
     "@chat-adapter/telegram": "4.41.1",
     "@cursor/sdk": "1.0.40",
-    "@desplega.ai/agent-fs-just-bash": "0.18.5",
+    "@desplega.ai/agent-fs-just-bash": "0.18.9",
     "@desplega.ai/business-use": "^0.4.2",
     "@earendil-works/pi-agent-core": "^1.4.0",
     "@earendil-works/pi-ai": "^1.4.0",

package/src/be/automation-preflight.ts

@@ -3,6 +3,7 @@ import { getSlackConfiguration, isSlackConfigured } from "../slack/config";
 import { isEnvFlagEnabled } from "../utils/env-flag";
 import { scrubSecrets } from "../utils/secret-scrubber";
 import { getDbClient } from "./db";
+import { emitRunFinished } from "./db/workflow-runs";
 import { getOAuthApp, getOAuthTokens } from "./db-queries/oauth";
 import { scrubJsonValue } from "./scrub-json";
 
@@ -446,6 +447,7 @@ export async function recordWorkflowPreflightFailure(input: {
         timestamp,
       ],
     );
+    emitRunFinished(runId, input.workflowId, "failed");
     // Claimed in this transaction, which also sees every child failure run
     // committed before it: concurrent failures alert exactly once a day.
     return {

package/src/be/db/api-keys.ts

@@ -110,6 +110,15 @@ export async function recordKeyValidation(
           now,
         ],
       );
+      // A passing test clears the key's rejection in every scope, since the
+      // suffix read in `getAvailableKeyIndices` matches them all.
+      if (key.ok) {
+        await tx.run(
+          `UPDATE api_key_status SET lastValidationError = NULL, lastValidationFailedAt = NULL, updatedAt = ?
+           WHERE keyType = ? AND keySuffix = ? AND lastValidationFailedAt IS NOT NULL`,
+          [now, keyType, key.keySuffix],
+        );
+      }
     }
     if (options.retireAbsent === false) return;
     const placeholders = keys.map(() => "?").join(", ");

package/src/be/db/workflow-runs.ts

@@ -465,7 +465,8 @@ export async function disarmWorkflowTreeRetries(
 /**
  * Mark the given runs that are still running or waiting `cancelled`, without
  * the per-run `workflow.child.finished` wake-up: it is for runs whose parent
- * step the same cancel closes. A terminal run keeps its status and reason.
+ * step the same cancel closes. Each run it cancels still emits
+ * `workflow.run.finished`. A terminal run keeps its status and reason.
  */
 export async function cancelLiveWorkflowTreeRuns(
   runIds: string[],
@@ -473,12 +474,14 @@ export async function cancelLiveWorkflowTreeRuns(
   finishedAt: string,
 ): Promise<void> {
   await forEachChunk(runIds, async (chunk, placeholders) => {
-    await getDbClient().run(
+    const cancelled = await getDbClient().query<{ id: string; workflowId: string }>(
       `UPDATE workflow_runs
           SET status = 'cancelled', error = ?, finishedAt = ?, lastUpdatedAt = ?
-        WHERE id IN (${placeholders}) AND status IN ('running', 'waiting')`,
+        WHERE id IN (${placeholders}) AND status IN ('running', 'waiting')
+        RETURNING id, workflowId`,
       [scrubSecrets(reason), finishedAt, finishedAt, ...chunk],
     );
+    for (const run of cancelled) emitRunFinished(run.id, run.workflowId, "cancelled");
   });
 }
 
@@ -643,14 +646,42 @@ export function emitChildRunFinished(
 }
 
 function emitAfterCommit(childRunId: string, parentStepId: string): void {
+  emitBusEventAfterCommit("workflow.child.finished", { childRunId, parentStepId });
+}
+
+/** Bus event every run emits once when it turns terminal. */
+export const WORKFLOW_RUN_FINISHED_EVENT = "workflow.run.finished";
+
+export function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean {
+  return TERMINAL_STATUSES.has(status);
+}
+
+/**
+ * Announce after commit that a run turned terminal, top-level and child runs
+ * alike, so an event-mode `wait` can resume when any run ends. Callers emit
+ * only when a live run (running or waiting) turns terminal, never on a later
+ * update of a run that is already terminal. The id is `runId`, never `workflowRunId` or
+ * `_runId`: those would put the finished run in the waiting run's own `run`
+ * scope, so waiters use scope `global` and filter on `runId`.
+ */
+export function emitRunFinished(
+  runId: string,
+  workflowId: string,
+  status: WorkflowRunStatus,
+): void {
+  if (!TERMINAL_STATUSES.has(status)) return;
+  emitBusEventAfterCommit(WORKFLOW_RUN_FINISHED_EVENT, { runId, workflowId, status });
+}
+
+function emitBusEventAfterCommit(event: string, payload: Record<string, unknown>): void {
   getDbClient().afterCommit(() => {
     import("../../workflows/event-bus")
       .then(({ workflowEventBus }) => {
-        workflowEventBus.emit("workflow.child.finished", { childRunId, parentStepId });
+        workflowEventBus.emit(event, payload);
       })
       .catch((err) =>
         console.error(
-          "[db] workflow.child.finished event not emitted:",
+          `[db] ${event} event not emitted:`,
           scrubSecrets(err instanceof Error ? err.message : String(err)),
         ),
       );