@desplega.ai/agent-swarm 2.6.0 → 2.7.1

package/src/tests/credential-check.test.ts

@@ -1323,10 +1323,12 @@ describe("NaN and Helmcode live probes", () => {
 // ─── Migration 055: report composition + opt-out ────────────────────────────
 
 describe("isCredCheckDisabled", () => {
-  test("true only when CRED_CHECK_DISABLE === '1'", () => {
+  test("true when CRED_CHECK_DISABLE is '1' or 'true' (case-insensitive)", () => {
     expect(isCredCheckDisabled({})).toBe(false);
     expect(isCredCheckDisabled({ CRED_CHECK_DISABLE: "0" })).toBe(false);
-    expect(isCredCheckDisabled({ CRED_CHECK_DISABLE: "true" })).toBe(false);
+    expect(isCredCheckDisabled({ CRED_CHECK_DISABLE: "false" })).toBe(false);
+    expect(isCredCheckDisabled({ CRED_CHECK_DISABLE: "true" })).toBe(true);
+    expect(isCredCheckDisabled({ CRED_CHECK_DISABLE: "TRUE" })).toBe(true);
     expect(isCredCheckDisabled({ CRED_CHECK_DISABLE: "1" })).toBe(true);
   });
 });

package/src/tests/docs-index-footprint.test.js

@@ -78,7 +78,7 @@ describe("docs API index footprint", () => {
     expect(tasks).toContain('"path":"/api/task-templates","method":"get"');
   });
 
-  test("OpenAPI and generated pages keep all 456 operations", async () => {
+  test("OpenAPI and generated pages keep all 466 operations", async () => {
     const spec = await Bun.file(resolve(repoRoot, "openapi.json")).json();
     const operationKeys = [];
     const tags = new Set();
@@ -103,8 +103,8 @@ describe("docs API index footprint", () => {
     expect(spec.paths["/api/agents/{id}/runtime"]?.get).toBeDefined();
 
     const generatedKeys = await generatedOperationKeys();
-    expect(operationKeys).toHaveLength(456);
-    expect(generatedKeys).toHaveLength(456);
+    expect(operationKeys).toHaveLength(466);
+    expect(generatedKeys).toHaveLength(466);
     expect(new Set(generatedKeys)).toEqual(new Set(operationKeys));
   });
 

package/src/tests/docs-index.test.ts

@@ -0,0 +1,135 @@
+import { afterAll, beforeAll, describe, expect, test } from "bun:test";
+import { mkdir, mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import {
+  collectDocsPages,
+  coverageErrors,
+  INDEX_END,
+  INDEX_START,
+  renderDocsIndex,
+  replaceIndexBlock,
+  SKILL_CONTENT_PATH,
+} from "../../scripts/build-docs-index";
+import { loadSeedSkills } from "../be/seed-skills";
+
+const page = (frontmatter: string, body = "Body.\n") => `---\n${frontmatter}\n---\n\n${body}`;
+
+describe("docs index (real docs tree)", () => {
+  test("every playbook is in the index and the coverage rules pass", async () => {
+    const pages = await collectDocsPages();
+    expect(coverageErrors(pages)).toEqual([]);
+
+    const index = renderDocsIndex(pages);
+    const playbooks = pages.filter((p) => p.path.startsWith("playbooks/"));
+    expect(playbooks.length).toBeGreaterThan(10);
+    for (const playbook of playbooks) {
+      expect(index).toContain(`(https://docs.agent-swarm.dev/docs/${playbook.slug})`);
+    }
+    // Positive control: a known playbook carries its trigger.
+    expect(index).toContain(
+      "[Open Oncall](https://docs.agent-swarm.dev/docs/playbooks/open-oncall). When: ",
+    );
+    // Negative control: opted-out pages are reference only, release notes are skipped.
+    expect(index).toContain("(https://docs.agent-swarm.dev/docs/playbooks). Reference.");
+    expect(index).not.toContain("/docs/releases/");
+  });
+
+  test("the committed skill body matches the generator", async () => {
+    const content = await Bun.file(SKILL_CONTENT_PATH).text();
+    const regenerated = replaceIndexBlock(content, renderDocsIndex(await collectDocsPages()));
+    expect(content).toBe(regenerated);
+  });
+
+  test("the generator is deterministic", async () => {
+    const first = renderDocsIndex(await collectDocsPages());
+    const second = renderDocsIndex(await collectDocsPages());
+    expect(second).toBe(first);
+  });
+
+  test("the seeded skill is a system default and carries the index", async () => {
+    const skill = (await loadSeedSkills()).find((s) => s.name === "swarm-docs");
+    expect(skill?.systemDefault).toBe(true);
+    expect(skill?.content).toContain("https://docs.agent-swarm.dev/docs/playbooks/open-oncall");
+  });
+});
+
+describe("docs index (fixture tree)", () => {
+  let root: string;
+
+  beforeAll(async () => {
+    root = await mkdtemp(join(tmpdir(), "docs-index-"));
+    await mkdir(join(root, "playbooks"), { recursive: true });
+    await mkdir(join(root, "guides"), { recursive: true });
+    await mkdir(join(root, "releases"), { recursive: true });
+    await Bun.write(join(root, "meta.json"), JSON.stringify({ pages: ["index", "playbooks"] }));
+    await Bun.write(join(root, "index.mdx"), page("title: Home"));
+    await Bun.write(
+      join(root, "playbooks", "meta.json"),
+      JSON.stringify({ pages: ["index", "b", "---Separator---", "a"] }),
+    );
+    await Bun.write(
+      join(root, "playbooks", "index.mdx"),
+      page("title: Playbooks\nagent:\n  offer: false"),
+    );
+    await Bun.write(
+      join(root, "playbooks", "a.mdx"),
+      page('title: A\nagent:\n  when: "Someone wants A"\n  template: "community/a"'),
+    );
+    await Bun.write(join(root, "playbooks", "b.mdx"), page("title: B"));
+    await Bun.write(
+      join(root, "guides", "g.mdx"),
+      page("title: G\nagent:\n  offer: true\n  notWhen: never"),
+    );
+    await Bun.write(join(root, "releases", "r.mdx"), page("title: R"));
+  });
+
+  afterAll(async () => {
+    await rm(root, { recursive: true, force: true });
+  });
+
+  test("orders by meta.json, appends unlisted folders, and skips releases", async () => {
+    const pages = await collectDocsPages(root);
+    expect(pages.map((p) => p.path)).toEqual([
+      "index",
+      "playbooks/index",
+      "playbooks/b",
+      "playbooks/a",
+      "guides/g",
+    ]);
+    expect(pages.map((p) => p.slug)).toEqual([
+      "",
+      "playbooks",
+      "playbooks/b",
+      "playbooks/a",
+      "guides/g",
+    ]);
+  });
+
+  test("a playbook without when, and an offered guide without when, fail coverage", async () => {
+    const errors = coverageErrors(await collectDocsPages(root));
+    expect(errors).toEqual([
+      "playbooks/b: playbook needs agent.when (or agent.offer: false)",
+      "guides/g: agent.offer is true but agent.when is missing",
+    ]);
+  });
+
+  test("renders triggers and templates for offered pages only", async () => {
+    const index = renderDocsIndex(await collectDocsPages(root));
+    expect(index).toContain(
+      "- [A](https://docs.agent-swarm.dev/docs/playbooks/a). When: Someone wants A. Template: `community/a`.",
+    );
+    expect(index).toContain(
+      "- [Playbooks](https://docs.agent-swarm.dev/docs/playbooks). Reference.",
+    );
+    expect(index).toContain("- [Home](https://docs.agent-swarm.dev/docs)");
+  });
+
+  test("replaceIndexBlock swaps only the marked block and rejects missing markers", () => {
+    const content = `before\n${INDEX_START}\nold\n${INDEX_END}\nafter\n`;
+    expect(replaceIndexBlock(content, `${INDEX_START}\nnew\n${INDEX_END}`)).toBe(
+      `before\n${INDEX_START}\nnew\n${INDEX_END}\nafter\n`,
+    );
+    expect(() => replaceIndexBlock("no markers", "x")).toThrow();
+  });
+});

package/src/tests/dsh-adapter.test.ts

@@ -376,7 +376,7 @@ describe("dsh harness", () => {
     await rename(join(config.cwd, "dsh"), join(config.cwd, "npx"));
     config.env = { ...config.env, DSH_BINARY: "", PATH: config.cwd };
     await expect(new DshAdapter().createSession(config)).rejects.toThrow(
-      "dsh CLI not found. Install @deepseek-ai/dsh@0.2.1-rc.3",
+      "dsh CLI not found. Install @deepseek-ai/dsh@0.2.1-rc.4",
     );
     expect(await Bun.file(join(config.cwd, "invocation.json")).exists()).toBe(false);
   });

package/src/tests/fetch-resolved-env.test.ts

@@ -41,8 +41,12 @@ const defaultMockResponse: MockResponse = {
 const mockResponsesByAgentId = new Map<string, MockResponse>();
 const requestedRepoIds = new Map<string, string | null>();
 const requestedTaskIds = new Map<string, string | null>();
-/** Every `GET /api/keys/available` query string observed by the mock server, most recent last. */
+/**
+ * Every `GET /api/keys/available` query string observed by the mock server,
+ * most recent last, without `keySuffixes` (recorded in `keysAvailableSuffixes`).
+ */
 const keysAvailableRequests: string[] = [];
+const keysAvailableSuffixes: Array<string | null> = [];
 
 beforeAll(() => {
   server = Bun.serve({
@@ -63,7 +67,10 @@ beforeAll(() => {
       }
 
       if (url.pathname === "/api/keys/available") {
-        keysAvailableRequests.push(url.search);
+        const params = new URLSearchParams(url.search);
+        keysAvailableSuffixes.push(params.get("keySuffixes"));
+        params.delete("keySuffixes");
+        keysAvailableRequests.push(`?${params}`);
         const totalKeys = Number(url.searchParams.get("totalKeys") ?? "1");
         const availableIndices = Array.from({ length: totalKeys }, (_, i) => i);
         return Response.json({ success: true, availableIndices, totalKeys });
@@ -455,6 +462,13 @@ describe("fetchResolvedEnv", () => {
       expect(keysAvailableRequests).toEqual([
         "?keyType=CLAUDE_CODE_OAUTH_TOKEN&totalKeys=32&model=fable",
       ]);
+      // The pool's own suffixes, in order, so status is matched by key (issue #2425).
+      expect(keysAvailableSuffixes.at(-1)).toBe(
+        Object.values(envWithOauthPool(32))[0]!
+          .split(",")
+          .map((key) => key.slice(-5))
+          .join(","),
+      );
     });
 
     test("model: 'claude-fable-5-1' issues the same model=fable", async () => {

package/src/tests/fixtures/onboard/baseline-states.ts

@@ -0,0 +1,68 @@
+import { getPresetById } from "../../../commands/onboard/presets.ts";
+import { INITIAL_STATE, type OnboardState } from "../../../commands/onboard/types.ts";
+
+/**
+ * Deterministic onboard states, one per unattended preset plus one variant
+ * with every integration, Bedrock (profile) and Podman. The fixtures next to
+ * this file hold the compose and .env these states rendered before the
+ * agent-fs bundle existed, so flag-off output stays byte-identical.
+ */
+export const BASELINE_PRESET_IDS = ["full", "dev", "content", "research", "solo"] as const;
+
+function agentIdsFor(state: Pick<OnboardState, "services">): Record<string, string> {
+  const ids: Record<string, string> = {};
+  let n = 0;
+  const next = () => `00000000-0000-4000-8000-${String(++n).padStart(12, "0")}`;
+  for (const svc of state.services) {
+    if (svc.count === 1) {
+      ids[svc.isLead ? "lead" : `worker-${svc.role}`] = next();
+    } else {
+      for (let i = 1; i <= svc.count; i++) ids[`worker-${svc.role}-${i}`] = next();
+    }
+  }
+  return ids;
+}
+
+export function baselineState(presetId: string, variant: "default" | "all" = "default") {
+  const preset = getPresetById(presetId);
+  if (!preset) throw new Error(`unknown preset ${presetId}`);
+  const base: OnboardState = {
+    ...INITIAL_STATE,
+    nonInteractive: true,
+    presetId: preset.id,
+    services: preset.services,
+    apiKey: "example-test-api-key",
+    claudeOAuthToken: "example-test-oauth",
+    outputDir: "/tmp/onboard-fixture",
+  };
+  base.agentIds = agentIdsFor(base);
+  if (variant === "default") return base;
+  return {
+    ...base,
+    provider: "bedrock",
+    harness: "pi",
+    awsRegion: "us-east-1",
+    awsProfile: "example-profile",
+    modelOverride: "example-model",
+    containerEngine: "podman",
+    pullPolicy: "missing",
+    apiPort: 3999,
+    maxConcurrentTasks: 3,
+    integrations: { github: true, slack: true, gitlab: true, sentry: true },
+    githubToken: "example-gh",
+    githubEmail: "dev@example.com",
+    githubName: "Example Dev",
+    slackBotToken: "example-slack-bot",
+    slackSigningSecret: "example-slack-signing",
+    slackMode: "http",
+    gitlabToken: "example-gitlab",
+    gitlabEmail: "dev@example.com",
+    sentryToken: "example-sentry",
+    sentryOrg: "example-org",
+  } satisfies OnboardState;
+}
+
+export const BASELINE_CASES: { name: string; state: OnboardState }[] = [
+  ...BASELINE_PRESET_IDS.map((id) => ({ name: id, state: baselineState(id) })),
+  { name: "full-all", state: baselineState("full", "all") },
+];

package/src/tests/fixtures/onboard/content.compose.yml.txt

@@ -0,0 +1,190 @@
+# Docker Compose for Agent Swarm
+# Generated by `agent-swarm onboard`
+#
+# Usage:
+#   docker compose --env-file .env up -d
+#
+# Image version: set AGENT_SWARM_VERSION in .env to a published release.
+# Blank falls back to `latest`, which moves on every commit to main and is
+# not a release. Releases: https://github.com/desplega-ai/agent-swarm/releases
+# Upgrade/rollback (migrations are forward-only, so back up first):
+# https://github.com/desplega-ai/agent-swarm/blob/main/skills/agent-swarm/references/upgrade.md
+
+services:
+  swarm-api:
+    image: "ghcr.io/desplega-ai/agent-swarm:${AGENT_SWARM_VERSION:-latest}"
+    container_name: swarm-api
+    pull_policy: always
+    stop_grace_period: 60s
+
+    environment:
+      - API_KEY=${API_KEY}
+      - INSTALL_METHOD=${INSTALL_METHOD}
+      - INSTALL_PRESET=${INSTALL_PRESET:-}
+      - MEMORY_HYBRID_SEARCH=${MEMORY_HYBRID_SEARCH-1}
+      - MEMORY_GRAPH_EXPANSION=${MEMORY_GRAPH_EXPANSION-1}
+      - MEMORY_RATERS=${MEMORY_RATERS-implicit-citation,explicit-self}
+      - MEMORY_DEMOTION_FLOOR=${MEMORY_DEMOTION_FLOOR-1.0}
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - MCP_BASE_URL=http://localhost:3013
+      - APP_URL=https://app.agent-swarm.dev
+
+    ports:
+      - "3013:3013"
+
+    volumes:
+      - swarm_data:/app/data
+
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:3013/health || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+      start_period: 15s
+
+    restart: unless-stopped
+
+  lead:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:${AGENT_SWARM_VERSION:-latest}"
+    container_name: swarm-lead
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      swarm-api:
+        condition: service_healthy
+
+    environment:
+      - HARNESS_PROVIDER=${HARNESS_PROVIDER}
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      - MEMORY_RATERS=${MEMORY_RATERS-implicit-citation,explicit-self}
+      - AGENT_ID=00000000-0000-4000-8000-000000000001
+      - AGENT_NAME=Lead
+      - AGENT_ROLE=lead
+      - TEMPLATE_ID=official/lead
+      - MCP_BASE_URL=http://swarm-api:3013
+      - YOLO=true
+      - SWARM_URL=http://swarm-api:3013
+      - MAX_CONCURRENT_TASKS=2
+
+    ports:
+      - "3201:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_lead:/workspace/personal
+
+    restart: unless-stopped
+
+  worker-content-writer:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:${AGENT_SWARM_VERSION:-latest}"
+    container_name: swarm-worker-content-writer
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      swarm-api:
+        condition: service_healthy
+
+    environment:
+      - HARNESS_PROVIDER=${HARNESS_PROVIDER}
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      - MEMORY_RATERS=${MEMORY_RATERS-implicit-citation,explicit-self}
+      - AGENT_ID=00000000-0000-4000-8000-000000000002
+      - AGENT_NAME=Content Writer
+      - AGENT_ROLE=worker
+      - TEMPLATE_ID=official/content-writer
+      - MCP_BASE_URL=http://swarm-api:3013
+      - YOLO=true
+      - SWARM_URL=http://swarm-api:3013
+      - MAX_CONCURRENT_TASKS=1
+
+    ports:
+      - "3202:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_worker_content_writer:/workspace/personal
+
+    restart: unless-stopped
+
+  worker-content-reviewer:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:${AGENT_SWARM_VERSION:-latest}"
+    container_name: swarm-worker-content-reviewer
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      swarm-api:
+        condition: service_healthy
+
+    environment:
+      - HARNESS_PROVIDER=${HARNESS_PROVIDER}
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      - MEMORY_RATERS=${MEMORY_RATERS-implicit-citation,explicit-self}
+      - AGENT_ID=00000000-0000-4000-8000-000000000003
+      - AGENT_NAME=Content Reviewer
+      - AGENT_ROLE=worker
+      - TEMPLATE_ID=official/content-reviewer
+      - MCP_BASE_URL=http://swarm-api:3013
+      - YOLO=true
+      - SWARM_URL=http://swarm-api:3013
+      - MAX_CONCURRENT_TASKS=1
+
+    ports:
+      - "3203:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_worker_content_reviewer:/workspace/personal
+
+    restart: unless-stopped
+
+  worker-content-strategist:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:${AGENT_SWARM_VERSION:-latest}"
+    container_name: swarm-worker-content-strategist
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      swarm-api:
+        condition: service_healthy
+
+    environment:
+      - HARNESS_PROVIDER=${HARNESS_PROVIDER}
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      - MEMORY_RATERS=${MEMORY_RATERS-implicit-citation,explicit-self}
+      - AGENT_ID=00000000-0000-4000-8000-000000000004
+      - AGENT_NAME=Content Strategist
+      - AGENT_ROLE=worker
+      - TEMPLATE_ID=official/content-strategist
+      - MCP_BASE_URL=http://swarm-api:3013
+      - YOLO=true
+      - SWARM_URL=http://swarm-api:3013
+      - MAX_CONCURRENT_TASKS=1
+
+    ports:
+      - "3204:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_worker_content_strategist:/workspace/personal
+
+    restart: unless-stopped
+
+volumes:
+  swarm_data:
+  swarm_logs:
+  swarm_shared:
+  swarm_lead:
+  swarm_worker_content_writer:
+  swarm_worker_content_reviewer:
+  swarm_worker_content_strategist:

package/src/tests/fixtures/onboard/content.env.txt

@@ -0,0 +1,29 @@
+# === Core ===
+API_KEY=example-test-api-key
+MCP_BASE_URL=http://localhost:3013
+APP_URL=https://app.agent-swarm.dev
+# Pin a release, e.g. AGENT_SWARM_VERSION=1.150.0. Blank tracks `latest`.
+AGENT_SWARM_VERSION=
+INSTALL_METHOD=onboard_noninteractive
+INSTALL_PRESET=content
+
+# New-deployment memory preset: retrieval, citation ratings, self-rating hints.
+# Set MEMORY_RATERS= to disable all raters; leave SKIP_SESSION_SUMMARY unset.
+MEMORY_HYBRID_SEARCH=1
+MEMORY_GRAPH_EXPANSION=1
+MEMORY_RATERS=implicit-citation,explicit-self
+MEMORY_DEMOTION_FLOOR=1.0
+
+# === Authentication ===
+HARNESS_PROVIDER=claude
+CLAUDE_CODE_OAUTH_TOKEN=example-test-oauth
+
+# === Integrations ===
+GITHUB_DISABLE=true
+SLACK_DISABLE=true
+
+# === Agent IDs (for reference) ===
+# lead = 00000000-0000-4000-8000-000000000001
+# worker-content-writer = 00000000-0000-4000-8000-000000000002
+# worker-content-reviewer = 00000000-0000-4000-8000-000000000003
+# worker-content-strategist = 00000000-0000-4000-8000-000000000004

package/src/tests/fixtures/onboard/dev.compose.yml.txt

@@ -0,0 +1,155 @@
+# Docker Compose for Agent Swarm
+# Generated by `agent-swarm onboard`
+#
+# Usage:
+#   docker compose --env-file .env up -d
+#
+# Image version: set AGENT_SWARM_VERSION in .env to a published release.
+# Blank falls back to `latest`, which moves on every commit to main and is
+# not a release. Releases: https://github.com/desplega-ai/agent-swarm/releases
+# Upgrade/rollback (migrations are forward-only, so back up first):
+# https://github.com/desplega-ai/agent-swarm/blob/main/skills/agent-swarm/references/upgrade.md
+
+services:
+  swarm-api:
+    image: "ghcr.io/desplega-ai/agent-swarm:${AGENT_SWARM_VERSION:-latest}"
+    container_name: swarm-api
+    pull_policy: always
+    stop_grace_period: 60s
+
+    environment:
+      - API_KEY=${API_KEY}
+      - INSTALL_METHOD=${INSTALL_METHOD}
+      - INSTALL_PRESET=${INSTALL_PRESET:-}
+      - MEMORY_HYBRID_SEARCH=${MEMORY_HYBRID_SEARCH-1}
+      - MEMORY_GRAPH_EXPANSION=${MEMORY_GRAPH_EXPANSION-1}
+      - MEMORY_RATERS=${MEMORY_RATERS-implicit-citation,explicit-self}
+      - MEMORY_DEMOTION_FLOOR=${MEMORY_DEMOTION_FLOOR-1.0}
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - MCP_BASE_URL=http://localhost:3013
+      - APP_URL=https://app.agent-swarm.dev
+
+    ports:
+      - "3013:3013"
+
+    volumes:
+      - swarm_data:/app/data
+
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:3013/health || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+      start_period: 15s
+
+    restart: unless-stopped
+
+  lead:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:${AGENT_SWARM_VERSION:-latest}"
+    container_name: swarm-lead
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      swarm-api:
+        condition: service_healthy
+
+    environment:
+      - HARNESS_PROVIDER=${HARNESS_PROVIDER}
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      - MEMORY_RATERS=${MEMORY_RATERS-implicit-citation,explicit-self}
+      - AGENT_ID=00000000-0000-4000-8000-000000000001
+      - AGENT_NAME=Lead
+      - AGENT_ROLE=lead
+      - TEMPLATE_ID=official/lead
+      - MCP_BASE_URL=http://swarm-api:3013
+      - YOLO=true
+      - SWARM_URL=http://swarm-api:3013
+      - MAX_CONCURRENT_TASKS=2
+
+    ports:
+      - "3201:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_lead:/workspace/personal
+
+    restart: unless-stopped
+
+  worker-coder-1:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:${AGENT_SWARM_VERSION:-latest}"
+    container_name: swarm-worker-coder-1
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      swarm-api:
+        condition: service_healthy
+
+    environment:
+      - HARNESS_PROVIDER=${HARNESS_PROVIDER}
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      - MEMORY_RATERS=${MEMORY_RATERS-implicit-citation,explicit-self}
+      - AGENT_ID=00000000-0000-4000-8000-000000000002
+      - AGENT_NAME=Coder 1
+      - AGENT_ROLE=worker
+      - TEMPLATE_ID=official/coder
+      - MCP_BASE_URL=http://swarm-api:3013
+      - YOLO=true
+      - SWARM_URL=http://swarm-api:3013
+      - MAX_CONCURRENT_TASKS=1
+
+    ports:
+      - "3202:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_worker_coder_1:/workspace/personal
+
+    restart: unless-stopped
+
+  worker-coder-2:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:${AGENT_SWARM_VERSION:-latest}"
+    container_name: swarm-worker-coder-2
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      swarm-api:
+        condition: service_healthy
+
+    environment:
+      - HARNESS_PROVIDER=${HARNESS_PROVIDER}
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      - MEMORY_RATERS=${MEMORY_RATERS-implicit-citation,explicit-self}
+      - AGENT_ID=00000000-0000-4000-8000-000000000003
+      - AGENT_NAME=Coder 2
+      - AGENT_ROLE=worker
+      - TEMPLATE_ID=official/coder
+      - MCP_BASE_URL=http://swarm-api:3013
+      - YOLO=true
+      - SWARM_URL=http://swarm-api:3013
+      - MAX_CONCURRENT_TASKS=1
+
+    ports:
+      - "3203:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_worker_coder_2:/workspace/personal
+
+    restart: unless-stopped
+
+volumes:
+  swarm_data:
+  swarm_logs:
+  swarm_shared:
+  swarm_lead:
+  swarm_worker_coder_1:
+  swarm_worker_coder_2: