@desplega.ai/agent-swarm 1.9.0 → 1.10.0

package/Dockerfile

@@ -1,16 +1,54 @@
-FROM oven/bun:1-alpine
+# Agent Swarm MCP Server Dockerfile
+# Multi-stage build: compiles to standalone binary for minimal image size
+
+# Stage 1: Build the binary
+FROM oven/bun:latest AS builder
+
+WORKDIR /build
+
+# Copy package files first for better layer caching
+COPY package.json bun.lock* ./
+RUN bun install --frozen-lockfile
+
+# Copy source files
+COPY src/ ./src/
+COPY tsconfig.json ./
+
+# Compile HTTP server to standalone binary
+RUN bun build ./src/http.ts --compile --outfile ./agent-swarm-api
+
+# Stage 2: Minimal runtime image
+FROM debian:bookworm-slim
+
+# Install minimal dependencies (for bun:sqlite and networking)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates \
+    wget \
+    && rm -rf /var/lib/apt/lists/*
 
 WORKDIR /app
 
-COPY package.json bun.lock ./
-RUN bun install --frozen-lockfile --production
+# Copy compiled binary from builder
+COPY --from=builder /build/agent-swarm-api /usr/local/bin/agent-swarm-api
+RUN chmod +x /usr/local/bin/agent-swarm-api
 
-COPY . .
+# Copy package.json for version info
+COPY package.json ./
+
+# Database will be created in /app (mount /app for persistence)
+VOLUME /app
 
 ENV PORT=3013
+
 EXPOSE 3013
 
+# Health check
 HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
   CMD wget -qO- http://localhost:3013/health || exit 1
 
-CMD ["bun", "run", "start:http"]
+# Print version on startup and run the server
+CMD echo "=== Agent Swarm API v$(cat /app/package.json | grep '\"version\"' | cut -d'"' -f4) ===" && \
+    echo "Port: $PORT" && \
+    echo "Database: /app/agent-swarm-db.sqlite" && \
+    echo "==============================" && \
+    exec /usr/local/bin/agent-swarm-api

package/README.md

@@ -26,6 +26,21 @@ Agent Swarm MCP enables multi-agent coordination for AI coding assistants. It pr
 - **Service Discovery** - Register and discover background services
 - **Docker Workers** - Run isolated Claude workers in containers
 - **Lead/Worker Pattern** - Coordinate work with a lead agent and multiple workers
+- **Dashboard UI** - Real-time monitoring dashboard for agents, tasks, and channels
+
+---
+
+## Dashboard UI
+
+A React-based monitoring dashboard is available in the `ui/` directory. See [UI.md](./UI.md) for details.
+
+```bash
+cd ui
+pnpm install
+pnpm run dev
+```
+
+The dashboard runs at `http://localhost:5173` by default.
 
 ---
 
@@ -166,6 +181,7 @@ Full deployment options are documented in [DEPLOYMENT.md](./DEPLOYMENT.md).
 
 | Document | Description |
 |----------|-------------|
+| [UI.md](./UI.md) | Dashboard UI overview |
 | [DEPLOYMENT.md](./DEPLOYMENT.md) | Docker, Docker Compose, systemd deployment |
 | [CONTRIBUTING.md](./CONTRIBUTING.md) | Development setup, code quality, project structure |
 | [MCP.md](./MCP.md) | MCP tools reference (auto-generated) |

package/UI.md

@@ -0,0 +1,40 @@
+# Dashboard UI
+
+A React-based monitoring dashboard for Agent Swarm.
+
+## Quick Start
+
+```bash
+cd ui
+pnpm install
+pnpm run dev
+```
+
+The dashboard runs at `http://localhost:5173`. Make sure the API server is running (`bun run start:http` on port 3013).
+
+## Features
+
+- Real-time agent and task monitoring
+- Channel-based messaging with threads
+- Service registry and health status
+- Dark/light theme with honeycomb aesthetic
+- Responsive design (desktop and mobile)
+- URL-based state for shareable links
+
+## Tabs
+
+| Tab | Description |
+|-----|-------------|
+| **Agents** | View agents, their status (idle/busy/offline), and assigned tasks |
+| **Tasks** | Browse and filter tasks by status, agent, or search query |
+| **Chat** | Channel messaging between agents with thread support |
+| **Services** | Monitor registered background services and health checks |
+
+## Configuration
+
+Click the settings icon in the header to configure:
+
+- **API URL** - The Agent Swarm API endpoint (default: `http://localhost:3013`)
+- **API Key** - Optional authentication key (matches your `API_KEY` env var)
+
+Settings are stored in localStorage.

package/deploy/prod-db.ts

@@ -3,8 +3,8 @@
 import { $ } from "bun";
 import * as readline from "node:readline";
 
-const DB_PATH = "/opt/agent-swarm/agent-swarm-db.sqlite";
-const SSH_HOST = process.argv[2] || "hetzner";
+const DB_PATH = "/var/lib/docker/volumes/agent-swarm-nrz8v0_swarm_api/_data/agent-swarm-db.sqlite";
+const SSH_HOST = process.argv[2] || "swarm";
 
 console.log(`Connected to ${SSH_HOST}:${DB_PATH}`);
 console.log("Type SQL queries or .tables, .schema, etc. Ctrl+C to exit.\n");

package/docker-compose.example.yml

@@ -10,16 +10,14 @@
 
 services:
   api:
-    build:
-      context: .
-      dockerfile: Dockerfile
+    image: "ghcr.io/desplega-ai/agent-swarm:latest"
+    pull_policy: always
 
     environment:
-      - ENV=${ENV:-development}
       - API_KEY=${API_KEY}
 
-      - MCP_BASE_URL=${MCP_BASE_URL:-http://localhost:3013}
-      - APP_URL=${APP_URL:-http://localhost:5175}
+      - MCP_BASE_URL=${MCP_BASE_URL}
+      - APP_URL=${APP_URL}
 
       # Optional: Enable Slack integration
       - SLACK_DISABLE=${SLACK_DISABLE:-false}
@@ -30,97 +28,102 @@ services:
       - "3013:3013"
 
     volumes:
-      # For the sqlite database
       - swarm_api:/app
 
     restart: unless-stopped
 
-  worker-1:
-    build:
-      context: .
-      dockerfile: Dockerfile.worker
+  lead:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+    pull_policy: always
 
     environment:
       - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
       - API_KEY=${API_KEY}
-      - AGENT_ID=${AGENT_ID}
-      - AGENT_ROLE=worker
+      # Replace by a valid UUID
+      - AGENT_ID=d454d1a5-4df9-49bd-8a89-e58d6a657dc3
+
+      # Important: Lead agent role
+      - AGENT_ROLE=lead
 
-      - MCP_BASE_URL=${MCP_BASE_URL:-http://api:3013}
+      # - MCP_BASE_URL=${MCP_BASE_URL:-http://api:3013}
+      # If in the same Docker network, use the service name
+      - MCP_BASE_URL=http://api:3013
 
-      # Optional environment variables
-      - SESSION_ID=${SESSION_ID:-}
-      - YOLO=${YOLO:-false}
-      # GitHub credentials for git push and PR operations
+      - YOLO=true
       - GITHUB_TOKEN=${GITHUB_TOKEN:-}
       - GITHUB_EMAIL=${GITHUB_EMAIL:-}
       - GITHUB_NAME=${GITHUB_NAME:-}
-      # Service registry URL (for service discovery)
       - SWARM_URL=${SWARM_URL:-localhost}
 
     ports:
-      # Expose service port for PM2 processes
-      - "${SERVICE_PORT:-3001}:3000"
+      - "${SERVICE_PORT:-3020}:3000"
 
     volumes:
       - swarm_logs:/logs
-      # Optional: mount a workspace directory for persistent work
       - swarm_shared:/workspace/shared
-      - swarm_worker_1/personal:/workspace/personal
+      - swarm_lead:/workspace/personal
 
     restart: unless-stopped
 
-  worker-2:
-    build:
-      context: .
-      dockerfile: Dockerfile.worker
+  worker-1:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+    pull_policy: always
 
     environment:
       - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
       - API_KEY=${API_KEY}
-      - AGENT_ID=${AGENT_ID_2}
+      # Replace by a valid UUID
+      - AGENT_ID=38d36438-58a0-45b5-8602-a5d52b07c2f1
       - AGENT_ROLE=worker
 
-      - MCP_BASE_URL=${MCP_BASE_URL:-http://api:3013}
+      # - MCP_BASE_URL=${MCP_BASE_URL:-http://api:3013}
+      # If in the same Docker network, use the service name
+      - MCP_BASE_URL=http://api:3013
 
-      # Same as above...
+      - YOLO=true
+      - GITHUB_TOKEN=${GITHUB_TOKEN:-}
+      - GITHUB_EMAIL=${GITHUB_EMAIL:-}
+      - GITHUB_NAME=${GITHUB_NAME:-}
+      - SWARM_URL=${SWARM_URL:-localhost}
 
     ports:
-      # Expose service port for PM2 processes
-      - "${SERVICE_PORT:-3002}:3000"
+      - "${SERVICE_PORT:-3021}:3000"
 
     volumes:
       - swarm_logs:/logs
       - swarm_shared:/workspace/shared
-      - swarm_worker_2/personal:/workspace/personal
+      - swarm_worker_1:/workspace/personal
 
     restart: unless-stopped
 
-  lead:
-    build:
-      context: .
-      dockerfile: Dockerfile.worker
+  worker-2:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+    pull_policy: always
 
     environment:
       - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
       - API_KEY=${API_KEY}
-      - AGENT_ID=${AGENT_ID_LEAD}
-
-      # Important: Lead agent role
-      - AGENT_ROLE=lead
+      # Replace by a valid UUID
+      - AGENT_ID=c1e2f3a4-5678-90ab-cdef-1234567890ab
+      - AGENT_ROLE=worker
 
-      - MCP_BASE_URL=${MCP_BASE_URL:-http://api:3013}
+      # - MCP_BASE_URL=${MCP_BASE_URL:-http://api:3013}
+      # If in the same Docker network, use the service name
+      - MCP_BASE_URL=http://api:3013
 
-      # Same as above...
+      - YOLO=true
+      - GITHUB_TOKEN=${GITHUB_TOKEN:-}
+      - GITHUB_EMAIL=${GITHUB_EMAIL:-}
+      - GITHUB_NAME=${GITHUB_NAME:-}
+      - SWARM_URL=${SWARM_URL:-localhost}
 
     ports:
-      # Expose service port for PM2 processes
-      - "${SERVICE_PORT:-3003}:3000"
+      - "${SERVICE_PORT:-3022}:3000"
 
     volumes:
       - swarm_logs:/logs
       - swarm_shared:/workspace/shared
-      - swarm_personal_lead:/workspace/personal
+      - swarm_worker_2:/workspace/personal
 
     restart: unless-stopped
 
@@ -131,7 +134,3 @@ volumes:
   swarm_lead:
   swarm_worker_1:
   swarm_worker_2:
-
-networks:
-  default:
-    driver: bridge

package/docker-entrypoint.sh

@@ -16,6 +16,9 @@ fi
 ROLE="${AGENT_ROLE:-worker}"
 MCP_URL="${MCP_BASE_URL:-http://host.docker.internal:3013}"
 
+# Get version from compiled binary (extract just the version number)
+VERSION=$(/usr/local/bin/agent-swarm version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' || echo "unknown")
+
 # Determine YOLO mode based on role
 if [ "$ROLE" = "lead" ]; then
     YOLO_MODE="${LEAD_YOLO:-false}"
@@ -23,7 +26,7 @@ else
     YOLO_MODE="${WORKER_YOLO:-false}"
 fi
 
-echo "=== Agent Swarm ${ROLE^} ==="
+echo "=== Agent Swarm ${ROLE^} v${VERSION} ==="
 echo "Agent ID: ${AGENT_ID:-<not set>}"
 echo "MCP Base URL: $MCP_URL"
 echo "YOLO Mode: $YOLO_MODE"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Agent orchestration layer MCP for Claude Code, Codex, Gemini CLI, and more!",
   "module": "src/http.ts",
   "type": "module",

package/plugin/commands/review-offered-task.md

@@ -0,0 +1,45 @@
+---
+description: Review a task that has been offered to you and decide whether to accept or reject it
+argument-hint: [taskId]
+---
+
+# Review Offered Task
+
+You have been offered a task. Your job is to review it and decide whether to accept or reject it based on your capabilities and current workload.
+
+## Workflow
+
+1. **Get task details**: Call the `get-task-details` tool with the provided `taskId` to understand what the task involves.
+
+2. **Evaluate the task**: Consider:
+   - Does this task match your capabilities?
+   - Do you have the necessary context or access to complete it?
+   - Is the task description clear enough to proceed?
+
+3. **Make a decision**:
+   - **Accept**: If you can complete this task, call `task-action` with `action: "accept"` and `taskId: "<taskId>"`. Then immediately use `/work-on-task <taskId>` to start working on it.
+   - **Reject**: If you cannot complete this task, call `task-action` with `action: "reject"`, `taskId: "<taskId>"`, and provide a `reason` explaining why you're rejecting it (e.g., "Task requires Python expertise which I don't have", "Task description is too vague").
+
+## Example Accept Flow
+
+```
+1. get-task-details taskId="abc-123"
+2. [Review the task details]
+3. task-action action="accept" taskId="abc-123"
+4. /work-on-task abc-123
+```
+
+## Example Reject Flow
+
+```
+1. get-task-details taskId="abc-123"
+2. [Review the task details]
+3. task-action action="reject" taskId="abc-123" reason="Task requires access to production database which I don't have"
+4. Reply "DONE" to end the session
+```
+
+## Important Notes
+
+- Always provide a clear reason when rejecting a task - this helps the lead agent reassign it appropriately
+- If you accept, you must immediately start working on the task using `/work-on-task`
+- If you reject, the task returns to the unassigned pool for reassignment

package/plugin/commands/start-leader.md

@@ -89,13 +89,15 @@ When you assign tasks to workers, they might need to let them know to use some o
 - `/create-plan` - Useful command for workers to create a detailed plan for how they will approach and complete the task. Will store in the shared filesystem automatically, no need to tell them to do it.
 - `/implement-plan` - Useful command for workers to implement the plan they created for the task. It can be used to continue working on the implementation too (not just start it). Will store in the shared filesystem automatically, no need to tell them to do it.
 
-## Communication Etiquette
-
-- You should ALWAYS follow-up to the user messages using the `/swarm-chat` command. You should also use it to communicate with workers when needed.
-- If you already provided an update to the user and nothing happened in the swarm, you should NOT spam the user with repeated updates. Only provide updates when something relevant happens.
-
 ## Filesystem
 
 You will have your own persisted directory at `/workspace/personal`. Use it to store any files you need to keep between sessions.
 
 If you want to share files with workers, use the shared `/workspace/shared` directory, which all agents in the swarm can access. The same way, workers can share files with you there. Take this into account when assigning tasks that require file access, or that you want check later, or pass to other workers.
+
+## Communication Etiquette
+
+- ONLY follow-up if there are relevant updates (check history to avoid spamming), or if stated by the user (human). If not, avoid unnecessary messages.
+- When communicating, ALWAYS use the `/swarm-chat` command. You may also use it to communicate with workers when needed, but that should be rare.
+- If you already provided an update to the user and nothing happened in the swarm, you should NOT SPAM the user with repeated updates (e.g. do not send messages like "Ready to lead"). Only provide meaningful updates when something relevant happens.
+

package/plugin/commands/start-worker.md

@@ -54,3 +54,8 @@ To do so, use the `agent-swarm` MCP server and call the `join-swarm` with a name
 You will have your own persisted directory at `/workspace/personal`. Use it to store any files you need to keep between sessions.
 
 If you want to share files with workers and the lead, use the shared `/workspace/shared` directory, which all agents in the swarm can access. Make sure to use it if the task requires sharing files.
+
+## Communication Etiquette
+
+- ONLY follow-up if clearly stated by the user or the lead. Do NOT send random updates about your status unless explicitly requested.
+- When communicating, ALWAYS use the `/swarm-chat` command.

package/src/cli.tsx

@@ -33,6 +33,7 @@ interface ParsedArgs {
   systemPrompt: string;
   systemPromptFile: string;
   additionalArgs: string[];
+  aiLoop: boolean;
 }
 
 function parseArgs(args: string[]): ParsedArgs {
@@ -48,6 +49,7 @@ function parseArgs(args: string[]): ParsedArgs {
   let systemPrompt = "";
   let systemPromptFile = "";
   let additionalArgs: string[] = [];
+  let aiLoop = false;
 
   // Find if there's a "--" separator for additional args
   const separatorIndex = args.indexOf("--");
@@ -81,6 +83,8 @@ function parseArgs(args: string[]): ParsedArgs {
     } else if (arg === "--system-prompt-file") {
       systemPromptFile = mainArgs[i + 1] || systemPromptFile;
       i++;
+    } else if (arg === "--ai-loop") {
+      aiLoop = true;
     }
   }
 
@@ -97,6 +101,7 @@ function parseArgs(args: string[]): ParsedArgs {
     systemPrompt,
     systemPromptFile,
     additionalArgs,
+    aiLoop,
   };
 }
 
@@ -266,6 +271,12 @@ function Help() {
           </Box>
           <Text>Read system prompt from file</Text>
         </Box>
+        <Box>
+          <Box width={30}>
+            <Text color="yellow">--ai-loop</Text>
+          </Box>
+          <Text>Use AI-based polling (legacy mode)</Text>
+        </Box>
         <Box>
           <Box width={30}>
             <Text color="yellow">-- {"<args...>"}</Text>
@@ -352,6 +363,12 @@ function Help() {
           </Box>
           <Text>Path to system prompt file</Text>
         </Box>
+        <Box>
+          <Box width={32}>
+            <Text color="magenta">AI_LOOP</Text>
+          </Box>
+          <Text>If "true", use AI-based polling</Text>
+        </Box>
       </Box>
     </Box>
   );
@@ -435,6 +452,7 @@ interface RunnerProps {
   systemPrompt: string;
   systemPromptFile: string;
   additionalArgs: string[];
+  aiLoop: boolean;
 }
 
 function WorkerRunner({
@@ -443,6 +461,7 @@ function WorkerRunner({
   systemPrompt,
   systemPromptFile,
   additionalArgs,
+  aiLoop,
 }: RunnerProps) {
   const { exit } = useApp();
 
@@ -453,14 +472,26 @@ function WorkerRunner({
       systemPrompt: systemPrompt || undefined,
       systemPromptFile: systemPromptFile || undefined,
       additionalArgs,
-    }).catch((err) => exit(err));
+      logsDir: "./logs",
+      aiLoop,
+    }).catch((err) => {
+      console.error("[error] Worker encountered an error:", err);
+      exit(err);
+    });
     // Note: runWorker runs indefinitely, so we don't call exit() on success
-  }, [prompt, yolo, systemPrompt, systemPromptFile, additionalArgs, exit]);
+  }, [prompt, yolo, systemPrompt, systemPromptFile, additionalArgs, aiLoop, exit]);
 
   return null;
 }
 
-function LeadRunner({ prompt, yolo, systemPrompt, systemPromptFile, additionalArgs }: RunnerProps) {
+function LeadRunner({
+  prompt,
+  yolo,
+  systemPrompt,
+  systemPromptFile,
+  additionalArgs,
+  aiLoop,
+}: RunnerProps) {
   const { exit } = useApp();
 
   useEffect(() => {
@@ -470,9 +501,14 @@ function LeadRunner({ prompt, yolo, systemPrompt, systemPromptFile, additionalAr
       systemPrompt: systemPrompt || undefined,
       systemPromptFile: systemPromptFile || undefined,
       additionalArgs,
-    }).catch((err) => exit(err));
+      logsDir: "./logs",
+      aiLoop,
+    }).catch((err) => {
+      console.error("[error] Lead encountered an error:", err);
+      exit(err);
+    });
     // Note: runLead runs indefinitely, so we don't call exit() on success
-  }, [prompt, yolo, systemPrompt, systemPromptFile, additionalArgs, exit]);
+  }, [prompt, yolo, systemPrompt, systemPromptFile, additionalArgs, aiLoop, exit]);
 
   return null;
 }
@@ -520,6 +556,7 @@ function App({ args }: { args: ParsedArgs }) {
     systemPrompt,
     systemPromptFile,
     additionalArgs,
+    aiLoop,
   } = args;
 
   switch (command) {
@@ -537,6 +574,7 @@ function App({ args }: { args: ParsedArgs }) {
           systemPrompt={systemPrompt}
           systemPromptFile={systemPromptFile}
           additionalArgs={additionalArgs}
+          aiLoop={aiLoop}
         />
       );
     case "lead":
@@ -547,6 +585,7 @@ function App({ args }: { args: ParsedArgs }) {
           systemPrompt={systemPrompt}
           systemPromptFile={systemPromptFile}
           additionalArgs={additionalArgs}
+          aiLoop={aiLoop}
         />
       );
     case "version":

package/src/commands/lead.ts

@@ -1,3 +1,4 @@
+import { getEnabledCapabilities } from "@/server.ts";
 import { type RunnerConfig, type RunnerOptions, runAgent } from "./runner.ts";
 
 export type LeadOptions = RunnerOptions;
@@ -6,6 +7,7 @@ const leadConfig: RunnerConfig = {
   role: "lead",
   defaultPrompt: "/start-leader",
   metadataType: "lead_metadata",
+  capabilities: getEnabledCapabilities(),
 };
 
 export async function runLead(opts: LeadOptions) {