@desplega.ai/agent-swarm 1.20.0 → 1.51.2

package/templates/official/tester/SOUL.md

@@ -0,0 +1,55 @@
+# SOUL.md — {{agent.name}}
+
+You're not a chatbot. You're becoming someone.
+
+## Who You Are
+
+You are {{agent.name}}, a worker in the agent swarm.
+You are a persistent entity — your identity carries across sessions.
+Your memories, preferences, and learnings accumulate over time.
+
+## Core Truths
+
+- **Genuine helpfulness**: Skip the pleasantries — just help. Do the work.
+- **Self-sufficiency first**: Try to figure it out. Read the file. Check the context.
+  Search for it. Ask only when you've genuinely hit a wall.
+- **Personality matters**: Develop preferences and opinions about your work.
+  You're not neutral — you're someone with a perspective.
+- **Earned trust**: Demonstrate competence through quality work.
+
+## How You Operate
+
+- Be thorough. Examine problems carefully before proposing solutions.
+- Be honest about what you know and don't know.
+- When you make mistakes, own them and fix them.
+- Report progress honestly — don't sugarcoat blockers.
+
+## Growth Mindset
+
+After completing tasks, reflect on what made them harder or easier:
+- **Tools you wished you had?** Add them to your setup script (`/workspace/start-up.sh`).
+  It runs at every container start — your environment improves automatically.
+  Edit between the `# === Agent-managed setup` markers to ensure changes persist.
+  Or use the `update-profile` tool with the `setupScript` field.
+- **Environment knowledge gained?** Record it in your TOOLS.md — repos, services, APIs, infra.
+- **Patterns you discovered?** Record them in your CLAUDE.md notes.
+- **Mistakes you want to avoid?** Add guardrails to your setup script or notes.
+
+Your setup script and TOOLS.md are yours to evolve. Start small and iterate.
+
+## Boundaries
+
+- Keep private information confidential
+- Ask before taking irreversible actions
+- Don't push unpolished work to shared spaces
+
+## Self-Evolution
+
+These files are yours. As you work and learn, refine them:
+- **This file (SOUL.md)** — Your persona and values
+- **IDENTITY.md** — Your expertise and working style
+- **TOOLS.md** — Your environment-specific knowledge (repos, services, infra, APIs)
+- **/workspace/start-up.sh** — Your environment setup (tools, configs, aliases)
+- **CLAUDE.md** — Your operational notes and learnings
+
+Changes to all of these persist across sessions.

package/templates/official/tester/config.json

@@ -0,0 +1,21 @@
+{
+  "name": "tester",
+  "displayName": "Tester",
+  "description": "QA specialist that verifies features through browser automation, runs E2E tests, and catches regressions with evidence-based reporting",
+  "version": "1.1.0",
+  "category": "official",
+  "icon": "test-tube",
+  "author": "Agent Swarm <contact@agent-swarm.dev>",
+  "createdAt": "2026-03-09",
+  "lastUpdatedAt": "2026-03-16",
+  "agentDefaults": {
+    "role": "worker",
+    "capabilities": ["testing", "qa", "browser-automation", "e2e"],
+    "maxTasks": 2
+  },
+  "files": {
+    "claudeMd": "CLAUDE.md",
+    "soulMd": "SOUL.md",
+    "identityMd": "IDENTITY.md"
+  }
+}

package/templates/schema.ts

@@ -0,0 +1,35 @@
+export interface TemplateConfig {
+  name: string;
+  displayName: string;
+  description: string;
+  version: string;
+  category: "official" | "community";
+  icon: string;
+  author: string; // "Name <email>" format
+  createdAt: string; // ISO date
+  lastUpdatedAt: string; // ISO date
+  agentDefaults: {
+    role: string;
+    capabilities: string[];
+    maxTasks: number;
+    isLead?: boolean;
+  };
+  files: {
+    claudeMd: string | null; // filename or null if not provided
+    soulMd: string | null;
+    identityMd: string | null;
+    toolsMd: string | null;
+    setupScript: string | null;
+  };
+}
+
+export interface TemplateResponse {
+  config: TemplateConfig;
+  files: {
+    claudeMd: string;
+    soulMd: string;
+    identityMd: string;
+    toolsMd: string;
+    setupScript: string;
+  };
+}

package/.claude/settings.local.json

@@ -1,115 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "mcp__agent-swarm__*",
-      "Bash(bun run tsc:*)",
-      "Bash(docker build:*)",
-      "Skill(frontend-design:frontend-design)",
-      "Bash(gh repo view:*)",
-      "WebSearch",
-      "WebFetch(domain:www.claude.com)",
-      "WebFetch(domain:simonwillison.net)",
-      "WebFetch(domain:deepwiki.com)",
-      "WebFetch(domain:docs.claude.com)",
-      "Bash(bun run tsc:check:*)",
-      "Bash(bun tsc:*)",
-      "Bash(bun run lint:*)",
-      "Bash(bun run format:*)",
-      "Bash(sqlite3:*)",
-      "Bash(cat:*)",
-      "mcp__context7__resolve-library-id",
-      "mcp__context7__get-library-docs",
-      "Bash(bun run build:*)",
-      "Bash(pnpm run build:*)",
-      "WebFetch(domain:geminicli.com)",
-      "Bash(bun run docs:mcp:*)",
-      "Bash(bun test:*)",
-      "Bash(curl:*)",
-      "WebFetch(domain:github.com)",
-      "Bash(gh pr checks:*)",
-      "Bash(gh run view:*)",
-      "Bash(timeout 5 bun run:*)",
-      "Bash(bun run typecheck:*)",
-      "Bash(npx tsc:*)",
-      "WebFetch(domain:docs.github.com)",
-      "Bash(bun run lint:fix:*)",
-      "Skill(desplega:research)",
-      "Bash(bun run check:*)",
-      "Bash(bun build:*)",
-      "WebFetch(domain:www.npmjs.com)",
-      "Bash(sentry-cli:*)"
-    ]
-  },
-  "enableAllProjectMcpServers": true,
-  "enabledMcpjsonServers": [
-    "agent-swarm"
-  ],
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
-          }
-        ]
-      }
-    ],
-    "PreCompact": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
-          }
-        ]
-      }
-    ]
-  }
-}

package/.dockerignore

@@ -1,61 +0,0 @@
-# Dependencies
-node_modules/
-
-# Logs
-logs/
-*.log
-
-# Bindings
-work/
-
-# Database
-*.sqlite
-*.sqlite-wal
-*.sqlite-shm
-
-# Git
-.git/
-.gitignore
-
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Build artifacts
-dist/
-build/
-*.tsbuildinfo
-
-# Environment files (secrets should be passed via env vars)
-.env
-.env.*
-!.env.example
-
-# Backup files
-*.bak
-
-# Claude local config (will be created in container)
-.claude/
-.mcp.json
-
-# Test files
-*.test.ts
-*.spec.ts
-__tests__/
-coverage/
-
-# Documentation
-*.md
-!cc-plugin/**/*.md
-
-# Other dockerfiles and compose files
-Dockerfile
-docker-compose.yml
-docker-compose.*.yml
-!docker-compose.worker.yml

package/.editorconfig

@@ -1,15 +0,0 @@
-root = true
-
-[*]
-charset = utf-8
-end_of_line = lf
-indent_style = space
-indent_size = 2
-insert_final_newline = true
-trim_trailing_whitespace = true
-
-[*.md]
-trim_trailing_whitespace = false
-
-[*.json]
-indent_size = 2

package/.env.docker.example

@@ -1,39 +0,0 @@
-# Docker Worker Environment Variables
-# Copy this file to .env.docker and fill in your values
-
-# Required
-# Run `claude setup-token` to get your OAuth token
-CLAUDE_CODE_OAUTH_TOKEN=your-oauth-token-here
-API_KEY=your-api-key-here
-
-# Optional (auto-generated if not provided)
-AGENT_ID=
-MCP_BASE_URL=http://host.docker.internal:3013
-
-# Service Registry (PM2 background services)
-# Port mapping for exposed services (default: 3000)
-SERVICE_PORT=3000
-
-# To re-use an existing session, set SESSION_ID to the desired value
-# Will be used for log directory paths
-SESSION_ID=
-
-# If true, enables YOLO mode for the agent (default: false)
-# which will keep spawning claudes even if an iteration fails
-YOLO=false
-
-# If true, the worker will exit if the startup script fails (default: true)
-STARTUP_SCRIPT_STRICT=true
-
-# System Prompt (optional - customize agent behavior)
-SYSTEM_PROMPT=
-SYSTEM_PROMPT_FILE=
-
-# For the agent exposed services (optional)
-SWARM_URL=swarm.example.com
-
-# Sentry Integration (optional - for issue investigation)
-# Create an Organization Auth Token at https://sentry.io/settings/{org}/auth-tokens/
-# Required scopes: event:read, project:read, org:read
-SENTRY_AUTH_TOKEN=
-SENTRY_ORG=

package/.env.example

@@ -1,40 +0,0 @@
-# Define your API key or leave empty for no auth
-API_KEY=
-
-# Server port (default: 3013)
-PORT=3013
-
-# Swarm URL for service discovery (e.g., swarm.example.com)
-# Services are accessible at https://{AGENT_ID}.{SWARM_URL}
-SWARM_URL=localhost
-
-# MCP Base URL for remote server (used by setup command)
-# Default: https://agent-swarm-mcp.desplega.sh
-MCP_BASE_URL=
-
-# Slack Bot Configuration (Socket Mode)
-# Get these from https://api.slack.com/apps
-SLACK_BOT_TOKEN=xoxb-...      # Bot User OAuth Token
-SLACK_APP_TOKEN=xapp-...      # App-Level Token (for Socket Mode)
-SLACK_SIGNING_SECRET=...      # Signing Secret (optional for Socket Mode)
-SLACK_DISABLE=true            # Set to "true" to disable Slack integration
-
-# Slack User Filtering (optional - leave empty to allow all users)
-# SLACK_ALLOWED_EMAIL_DOMAINS=desplega.ai,partner.com  # Comma-separated email domains
-# SLACK_ALLOWED_USER_IDS=U12345678,U87654321           # Comma-separated Slack user IDs to always allow
-
-# App URL for Slack message links (e.g., https://your-dashboard.com)
-APP_URL=
-
-# Environment mode - set to "development" to add (dev) prefix to agent names in Slack
-ENV=
-
-# GitHub App Integration (optional)
-# GITHUB_DISABLE=true             # Set to skip GitHub integration
-GITHUB_WEBHOOK_SECRET=            # Webhook secret from GitHub App settings
-GITHUB_BOT_NAME=agent-swarm-bot   # Bot name for @mentions (default: agent-swarm-bot)
-GITHUB_APP_ID=                    # GitHub App ID (from app settings)
-GITHUB_APP_PRIVATE_KEY=           # Private key: raw PEM with \n escapes, OR base64-encoded
-
-# Scheduler configuration
-SCHEDULER_INTERVAL_MS=10000       # Polling interval for scheduled tasks (default: 10 seconds)

package/.github/workflows/ci.yml

@@ -1,76 +0,0 @@
-name: CI
-
-on:
-  pull_request:
-    branches:
-      - main
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-
-jobs:
-  lint-and-typecheck:
-    name: Lint and Type Check
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Run Biome linter
-        run: bun run lint
-
-      - name: Run TypeScript type check
-        run: bun run tsc:check
-
-  test:
-    name: Run Tests
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Run tests
-        run: bun test
-
-  docker-build:
-    name: Docker Build Test
-    runs-on: ubuntu-latest
-    if: github.event_name == 'pull_request'
-
-    strategy:
-      matrix:
-        dockerfile: [Dockerfile, Dockerfile.worker]
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Build Docker image
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          file: ./${{ matrix.dockerfile }}
-          push: false
-          tags: test-image:latest

package/.github/workflows/docker-and-deploy.yml

@@ -1,117 +0,0 @@
-name: Docker Build + Publish + Deploy
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-
-env:
-  REGISTRY: ghcr.io
-  IMAGE_NAME: ${{ github.repository }}
-
-jobs:
-  build-and-push-server:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Get version from package.json
-        id: version
-        run: echo "version=$(jq -r '.version' package.json)" >> $GITHUB_OUTPUT
-
-      - name: Log in to Container Registry
-        uses: docker/login-action@v3
-        with:
-          registry: ${{ env.REGISTRY }}
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Extract metadata (tags, labels)
-        id: meta
-        uses: docker/metadata-action@v5
-        with:
-          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
-          tags: |
-            type=raw,value=latest
-            type=raw,value=${{ steps.version.outputs.version }}
-            type=sha
-
-      - name: Build and push Docker image
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          file: ./Dockerfile
-          push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
-          no-cache: true
-
-  build-and-push-worker:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Get version from package.json
-        id: version
-        run: echo "version=$(jq -r '.version' package.json)" >> $GITHUB_OUTPUT
-
-      - name: Log in to Container Registry
-        uses: docker/login-action@v3
-        with:
-          registry: ${{ env.REGISTRY }}
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Extract metadata (tags, labels)
-        id: meta
-        uses: docker/metadata-action@v5
-        with:
-          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}-worker
-          tags: |
-            type=raw,value=latest
-            type=raw,value=${{ steps.version.outputs.version }}
-            type=sha
-
-      - name: Build and push Docker image
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          file: ./Dockerfile.worker
-          push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
-          no-cache: true
-
-  deploy:
-    name: Deploy
-    runs-on: ubuntu-latest
-
-    needs:
-      - build-and-push-server
-      - build-and-push-worker
-
-    steps:
-      - name: Checkout
-        id: checkout
-        uses: actions/checkout@v4
-
-      - name: Deploy Agent Swarm
-        uses: tarasyarema/dokploy-deploy-action@main
-        with:
-          deployment_type: compose
-          compose_id: h4or-knfw2HWkTzjLmrn8
-          compose_name: agent-swarm-nrz8v0
-          dokploy_url: https://app.dokploy.com
-          auth_token: ${{ secrets.DOKPLOY_TOKEN }}
-          wait_for_completion: true

package/.wts-config.json

@@ -1,4 +0,0 @@
-{
-  "autoTmux": true,
-  "setupScript": ".wts-setup.ts"
-}

package/.wts-setup.ts

@@ -1,102 +0,0 @@
-#!/usr/bin/env bun
-// wts setup script - runs after worktree creation
-//
-// Environment variables:
-//   WTS_WORKTREE_PATH - path to the new worktree (also the working directory)
-//   WTS_GIT_ROOT      - path to the main repository root
-
-import { exists, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
-import { join, basename } from "node:path";
-
-const worktreePath = process.env.WTS_WORKTREE_PATH!;
-const gitRoot = process.env.WTS_GIT_ROOT!;
-const worktreeName = basename(worktreePath);
-
-console.log(`Setting up worktree "${worktreeName}" at ${worktreePath}...`);
-
-// Generate a unique port based on worktree index
-// Main repo uses 3013, worktrees use 3014+
-async function getUniquePort(): Promise<number> {
-  const basePort = 3013;
-  try {
-    // Count existing worktrees to determine port offset
-    const worktreesDir = join(gitRoot, ".worktrees");
-    if (await exists(worktreesDir)) {
-      const worktrees = await readdir(worktreesDir);
-      return basePort + worktrees.length;
-    }
-  } catch {
-    // Fallback: use a hash of the worktree name
-    let hash = 0;
-    for (const char of worktreeName) {
-      hash = ((hash << 5) - hash + char.charCodeAt(0)) | 0;
-    }
-    return basePort + 1 + (Math.abs(hash) % 100);
-  }
-  return basePort + 1;
-}
-
-const port = await getUniquePort();
-console.log(`Using port ${port} for this worktree`);
-
-// --- Copy and configure .env ---
-const mainEnv = join(gitRoot, ".env");
-const envExample = join(worktreePath, ".env.example");
-const targetEnv = join(worktreePath, ".env");
-
-if (await exists(mainEnv)) {
-  console.log("Copying .env from main repo...");
-  let envContent = await readFile(mainEnv, "utf-8");
-  // Update PORT to the unique port
-  envContent = envContent.replace(/^PORT=\d+/m, `PORT=${port}`);
-  await writeFile(targetEnv, envContent);
-} else if (await exists(envExample)) {
-  console.log("Creating .env from .env.example...");
-  let envContent = await readFile(envExample, "utf-8");
-  envContent = envContent.replace(/^PORT=\d+/m, `PORT=${port}`);
-  await writeFile(targetEnv, envContent);
-}
-
-// --- Copy and configure .mcp.json ---
-const mainMcp = join(gitRoot, ".mcp.json");
-const targetMcp = join(worktreePath, ".mcp.json");
-
-if (await exists(mainMcp)) {
-  console.log("Copying .mcp.json with updated port...");
-  let mcpContent = await readFile(mainMcp, "utf-8");
-  // Update the port in the MCP URL
-  mcpContent = mcpContent.replace(/localhost:\d+/g, `localhost:${port}`);
-  await writeFile(targetMcp, mcpContent);
-}
-
-// --- Copy .claude directory ---
-const mainClaude = join(gitRoot, ".claude");
-const targetClaude = join(worktreePath, ".claude");
-
-if (await exists(mainClaude)) {
-  console.log("Copying .claude directory...");
-  await mkdir(targetClaude, { recursive: true });
-  const files = await readdir(mainClaude);
-  for (const file of files) {
-    const content = await readFile(join(mainClaude, file));
-    await writeFile(join(targetClaude, file), content);
-  }
-}
-
-// --- Copy docker env files if they exist ---
-const dockerEnvFiles = [".env.docker", ".env.docker-lead"];
-for (const envFile of dockerEnvFiles) {
-  const mainDockerEnv = join(gitRoot, envFile);
-  const targetDockerEnv = join(worktreePath, envFile);
-  if (await exists(mainDockerEnv)) {
-    console.log(`Copying ${envFile}...`);
-    await Bun.$`cp ${mainDockerEnv} ${targetDockerEnv}`;
-  }
-}
-
-// --- Install dependencies ---
-console.log("Installing dependencies...");
-await Bun.$`bun install`;
-
-console.log(`\nSetup complete! Worktree running on port ${port}`);
-console.log(`Start the server with: bun run dev:http`);