opencode-swarm-plugin 0.2.0 → 0.3.0

package/.beads/issues.jsonl

@@ -24,7 +24,7 @@
 {"id":"opencode-swarm-plugin-1gtm","title":"Update test bead","description":"Original description","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:11:39.569462-08:00","updated_at":"2025-12-08T08:11:42.010151-08:00","closed_at":"2025-12-08T08:11:42.010151-08:00"}
 {"id":"opencode-swarm-plugin-1i8","title":"Test bead","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:23:49.873224-08:00","updated_at":"2025-12-07T19:24:13.408304-08:00","closed_at":"2025-12-07T19:24:13.408304-08:00"}
 {"id":"opencode-swarm-plugin-1j0t","title":"Bead to close","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T07:46:49.618076-08:00","updated_at":"2025-12-08T07:46:49.644609-08:00","closed_at":"2025-12-08T07:46:49.644609-08:00"}
-{"id":"opencode-swarm-plugin-1li","title":"Test parent","description":"","status":"open","priority":2,"issue_type":"epic","created_at":"2025-12-07T19:35:34.909384-08:00","updated_at":"2025-12-07T19:35:34.909384-08:00"}
+{"id":"opencode-swarm-plugin-1li","title":"Test parent","description":"","status":"closed","priority":2,"issue_type":"epic","created_at":"2025-12-07T19:35:34.909384-08:00","updated_at":"2025-12-08T08:35:24.648164-08:00","closed_at":"2025-12-08T08:35:24.648164-08:00"}
 {"id":"opencode-swarm-plugin-1li.1","title":"Test child","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-07T19:35:39.491063-08:00","updated_at":"2025-12-07T19:35:39.491063-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-1li.1","depends_on_id":"opencode-swarm-plugin-1li","type":"parent-child","created_at":"2025-12-07T19:35:39.491364-08:00","created_by":"daemon"}]}
 {"id":"opencode-swarm-plugin-1lkv","title":"Query test bead","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:11:39.223436-08:00","updated_at":"2025-12-08T08:11:41.799207-08:00","closed_at":"2025-12-08T08:11:41.799207-08:00"}
 {"id":"opencode-swarm-plugin-1mre","title":"Test bead minimal","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T07:49:09.126035-08:00","updated_at":"2025-12-08T07:49:11.799933-08:00","closed_at":"2025-12-08T07:49:11.799933-08:00"}
@@ -67,6 +67,11 @@
 {"id":"opencode-swarm-plugin-37az","title":"Thread link test bead","description":"[thread:test-thread-123]","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:05:34.247814-08:00","updated_at":"2025-12-08T08:05:36.051352-08:00","closed_at":"2025-12-08T08:05:36.051352-08:00"}
 {"id":"opencode-swarm-plugin-3c0h","title":"Limit test bead 3","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:57:06.042676-08:00","updated_at":"2025-12-07T19:57:08.336974-08:00","closed_at":"2025-12-07T19:57:08.336974-08:00"}
 {"id":"opencode-swarm-plugin-3e3o","title":"Thread link test bead","description":"Important context here\n\n[thread:test-thread-789]","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T07:46:50.71229-08:00","updated_at":"2025-12-08T07:46:52.478079-08:00","closed_at":"2025-12-08T07:46:52.478079-08:00"}
+{"id":"opencode-swarm-plugin-3fa7","title":"Add rate limiting to Agent Mail","description":"Implement per-agent rate limiting with Redis backend to prevent abuse","status":"closed","priority":2,"issue_type":"epic","created_at":"2025-12-08T08:28:07.547069-08:00","updated_at":"2025-12-08T08:29:09.032995-08:00","closed_at":"2025-12-08T08:29:09.032995-08:00"}
+{"id":"opencode-swarm-plugin-3fa7.1","title":"Add Redis dependency and connection","description":"Add redis-py to requirements.txt and create Redis connection helper","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:28:14.489575-08:00","updated_at":"2025-12-08T08:28:54.193001-08:00","closed_at":"2025-12-08T08:28:54.193001-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-3fa7.1","depends_on_id":"opencode-swarm-plugin-3fa7","type":"parent-child","created_at":"2025-12-08T08:28:14.489983-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-3fa7.2","title":"Implement rate limiter class","description":"Create RateLimiter class using Redis sorted sets for sliding window rate limiting","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:28:14.527429-08:00","updated_at":"2025-12-08T08:29:08.941471-08:00","closed_at":"2025-12-08T08:29:08.941471-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-3fa7.2","depends_on_id":"opencode-swarm-plugin-3fa7","type":"parent-child","created_at":"2025-12-08T08:28:14.527749-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-3fa7.3","title":"Integrate rate limiting into API endpoints","description":"Add rate limiting middleware to send_message and other high-traffic endpoints","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:28:14.563509-08:00","updated_at":"2025-12-08T08:29:08.973236-08:00","closed_at":"2025-12-08T08:29:08.973236-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-3fa7.3","depends_on_id":"opencode-swarm-plugin-3fa7","type":"parent-child","created_at":"2025-12-08T08:28:14.563815-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-3fa7.4","title":"Add rate limit configuration and tests","description":"Add rate limit config to docker-compose.yml and create integration tests","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:28:14.601283-08:00","updated_at":"2025-12-08T08:29:09.002331-08:00","closed_at":"2025-12-08T08:29:09.002331-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-3fa7.4","depends_on_id":"opencode-swarm-plugin-3fa7","type":"parent-child","created_at":"2025-12-08T08:28:14.601636-08:00","created_by":"daemon"}]}
 {"id":"opencode-swarm-plugin-3fw","title":"Integration test epic","description":"Testing epic creation","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-07T19:37:34.859822-08:00","updated_at":"2025-12-07T19:37:36.450884-08:00","closed_at":"2025-12-07T19:37:36.450884-08:00"}
 {"id":"opencode-swarm-plugin-3fw.1","title":"Subtask 1","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:37:34.888133-08:00","updated_at":"2025-12-07T19:37:36.473973-08:00","closed_at":"2025-12-07T19:37:36.473973-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-3fw.1","depends_on_id":"opencode-swarm-plugin-3fw","type":"parent-child","created_at":"2025-12-07T19:37:34.888439-08:00","created_by":"daemon"}]}
 {"id":"opencode-swarm-plugin-3fw.2","title":"Subtask 2","description":"","status":"closed","priority":3,"issue_type":"task","created_at":"2025-12-07T19:37:34.915829-08:00","updated_at":"2025-12-07T19:37:36.494929-08:00","closed_at":"2025-12-07T19:37:36.494929-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-3fw.2","depends_on_id":"opencode-swarm-plugin-3fw","type":"parent-child","created_at":"2025-12-07T19:37:34.916128-08:00","created_by":"daemon"}]}
@@ -157,6 +162,11 @@
 {"id":"opencode-swarm-plugin-6ep7","title":"Test bug with priority","description":"This is a critical bug","status":"closed","priority":0,"issue_type":"bug","created_at":"2025-12-08T08:11:38.996265-08:00","updated_at":"2025-12-08T08:11:41.663466-08:00","closed_at":"2025-12-08T08:11:41.663466-08:00"}
 {"id":"opencode-swarm-plugin-6jd","title":"Test bead minimal","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:37:33.768675-08:00","updated_at":"2025-12-07T19:37:35.990589-08:00","closed_at":"2025-12-07T19:37:35.990589-08:00"}
 {"id":"opencode-swarm-plugin-6k55","title":"Test bug with priority","description":"This is a critical bug","status":"closed","priority":0,"issue_type":"bug","created_at":"2025-12-07T19:57:05.655726-08:00","updated_at":"2025-12-07T19:57:08.099897-08:00","closed_at":"2025-12-07T19:57:08.099897-08:00"}
+{"id":"opencode-swarm-plugin-6ocg","title":"Add rate limiting to Agent Mail server","description":"Implement per-agent rate limiting with Redis primary and SQLite fallback. Prevents abuse and runaway agents.","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-08T08:34:33.28449-08:00","updated_at":"2025-12-08T08:35:41.856259-08:00","closed_at":"2025-12-08T08:35:41.856259-08:00"}
+{"id":"opencode-swarm-plugin-6ocg.1","title":"Add rate limiter module with Redis/SQLite backends","description":"Create rate_limiter.py with RateLimiter class. Redis primary (sliding window with sorted sets), SQLite fallback (COUNT query). Configurable limits per endpoint.","status":"closed","priority":1,"issue_type":"task","created_at":"2025-12-08T08:34:44.240115-08:00","updated_at":"2025-12-08T08:35:42.506425-08:00","closed_at":"2025-12-08T08:35:42.506425-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-6ocg.1","depends_on_id":"opencode-swarm-plugin-6ocg","type":"parent-child","created_at":"2025-12-08T08:34:44.240449-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-6ocg.2","title":"Integrate rate limiting into send_message endpoint","description":"Add rate limit check to tool_send_message. Return 429 with retry-after header when exceeded. Track by agent_id.","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:34:44.278972-08:00","updated_at":"2025-12-08T08:35:43.041616-08:00","closed_at":"2025-12-08T08:35:43.041616-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-6ocg.2","depends_on_id":"opencode-swarm-plugin-6ocg","type":"parent-child","created_at":"2025-12-08T08:34:44.279328-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-6ocg.3","title":"Add rate limit configuration and Docker setup","description":"Add Redis to docker-compose.yml. Add RATE_LIMIT_* env vars. Update requirements.txt with redis-py.","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:34:44.317207-08:00","updated_at":"2025-12-08T08:35:43.593244-08:00","closed_at":"2025-12-08T08:35:43.593244-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-6ocg.3","depends_on_id":"opencode-swarm-plugin-6ocg","type":"parent-child","created_at":"2025-12-08T08:34:44.317517-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-6ocg.4","title":"Add rate limiter integration tests","description":"Test rate limiting behavior: limit enforcement, Redis failover to SQLite, 429 responses, retry-after headers.","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:34:44.355231-08:00","updated_at":"2025-12-08T08:35:44.087082-08:00","closed_at":"2025-12-08T08:35:44.087082-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-6ocg.4","depends_on_id":"opencode-swarm-plugin-6ocg","type":"parent-child","created_at":"2025-12-08T08:34:44.355586-08:00","created_by":"daemon"}]}
 {"id":"opencode-swarm-plugin-6oty","title":"Lifecycle test bead","description":"50% complete","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:14:30.448872-08:00","updated_at":"2025-12-08T08:14:30.527881-08:00","closed_at":"2025-12-08T08:14:30.527881-08:00"}
 {"id":"opencode-swarm-plugin-6p6h","title":"High priority ready bead","description":"","status":"closed","priority":0,"issue_type":"task","created_at":"2025-12-08T07:53:44.648855-08:00","updated_at":"2025-12-08T07:53:46.605112-08:00","closed_at":"2025-12-08T07:53:46.605112-08:00"}
 {"id":"opencode-swarm-plugin-6rs3","title":"Update test bead","description":"Original description","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:41:11.205193-08:00","updated_at":"2025-12-07T19:41:13.573642-08:00","closed_at":"2025-12-07T19:41:13.573642-08:00"}
@@ -248,7 +258,7 @@
 {"id":"opencode-swarm-plugin-a1qj","title":"Bead to start","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T07:49:10.19575-08:00","updated_at":"2025-12-08T07:49:12.301943-08:00","closed_at":"2025-12-08T07:49:12.301943-08:00"}
 {"id":"opencode-swarm-plugin-a1tr","title":"Cleanup task","description":"","status":"closed","priority":3,"issue_type":"chore","created_at":"2025-12-07T19:41:10.702003-08:00","updated_at":"2025-12-07T19:41:13.300043-08:00","closed_at":"2025-12-07T19:41:13.300043-08:00"}
 {"id":"opencode-swarm-plugin-a2p6","title":"Bead to close","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:57:06.489496-08:00","updated_at":"2025-12-07T19:57:06.515662-08:00","closed_at":"2025-12-07T19:57:06.515662-08:00"}
-{"id":"opencode-swarm-plugin-a2v","title":"Docker integration test infrastructure","description":"Create Docker-based integration test environment with real beads CLI and Agent Mail server for testing all plugin modules without mocks","status":"open","priority":1,"issue_type":"epic","created_at":"2025-12-07T19:23:43.835677-08:00","updated_at":"2025-12-07T19:23:43.835677-08:00"}
+{"id":"opencode-swarm-plugin-a2v","title":"Docker integration test infrastructure","description":"Create Docker-based integration test environment with real beads CLI and Agent Mail server for testing all plugin modules without mocks","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-07T19:23:43.835677-08:00","updated_at":"2025-12-08T08:35:23.531219-08:00","closed_at":"2025-12-08T08:35:23.531219-08:00"}
 {"id":"opencode-swarm-plugin-a3fa","title":"Lifecycle test bead","description":"50% complete","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:05:34.668388-08:00","updated_at":"2025-12-08T08:05:34.745926-08:00","closed_at":"2025-12-08T08:05:34.745926-08:00"}
 {"id":"opencode-swarm-plugin-a76x","title":"New feature request","description":"","status":"closed","priority":1,"issue_type":"feature","created_at":"2025-12-08T08:21:26.918472-08:00","updated_at":"2025-12-08T08:21:29.744733-08:00","closed_at":"2025-12-08T08:21:29.744733-08:00"}
 {"id":"opencode-swarm-plugin-a8y","title":"Epic with file references","description":"","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-07T19:39:10.635641-08:00","updated_at":"2025-12-07T19:39:12.218959-08:00","closed_at":"2025-12-07T19:39:12.218959-08:00"}
@@ -480,7 +490,7 @@
 {"id":"opencode-swarm-plugin-k2wm","title":"Thread link test bead","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:56:44.160426-08:00","updated_at":"2025-12-07T19:56:45.501563-08:00","closed_at":"2025-12-07T19:56:45.501563-08:00"}
 {"id":"opencode-swarm-plugin-k3ji","title":"Limit test bead 4","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:57:06.077162-08:00","updated_at":"2025-12-07T19:57:08.361319-08:00","closed_at":"2025-12-07T19:57:08.361319-08:00"}
 {"id":"opencode-swarm-plugin-k48x","title":"Bead to close","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T07:49:10.083654-08:00","updated_at":"2025-12-08T07:49:10.109594-08:00","closed_at":"2025-12-08T07:49:10.109594-08:00"}
-{"id":"opencode-swarm-plugin-k8d","title":"Docker integration test infrastructure","description":"Create Docker-based integration test environment with real beads CLI and Agent Mail server for testing all plugin modules without mocks","status":"open","priority":1,"issue_type":"epic","created_at":"2025-12-07T19:24:22.198656-08:00","updated_at":"2025-12-07T19:24:22.198656-08:00"}
+{"id":"opencode-swarm-plugin-k8d","title":"Docker integration test infrastructure","description":"Create Docker-based integration test environment with real beads CLI and Agent Mail server for testing all plugin modules without mocks","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-07T19:24:22.198656-08:00","updated_at":"2025-12-08T08:35:24.03232-08:00","closed_at":"2025-12-08T08:35:24.03232-08:00"}
 {"id":"opencode-swarm-plugin-k93","title":"High priority ready bead","description":"","status":"closed","priority":0,"issue_type":"task","created_at":"2025-12-07T19:39:10.444177-08:00","updated_at":"2025-12-07T19:39:12.109004-08:00","closed_at":"2025-12-07T19:39:12.109004-08:00"}
 {"id":"opencode-swarm-plugin-kci6","title":"Update test bead","description":"Updated description","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T07:53:44.191794-08:00","updated_at":"2025-12-08T07:53:46.477523-08:00","closed_at":"2025-12-08T07:53:46.477523-08:00"}
 {"id":"opencode-swarm-plugin-kcm4","title":"Query test bead","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:22:16.997856-08:00","updated_at":"2025-12-08T08:22:19.364091-08:00","closed_at":"2025-12-08T08:22:19.364091-08:00"}

package/README.md

@@ -17,6 +17,8 @@ This plugin provides intelligent, self-improving tools for multi-agent workflows
 - **Anti-pattern detection** - Automatically learns what decomposition strategies fail and avoids them
 - **Pre-completion validation** - UBS bug scanning before marking tasks complete
 - **History-informed decomposition** - Queries CASS for similar past tasks to inform strategy
+- **Graceful degradation** - Works with whatever tools are available, degrades features when tools missing
+- **Swarm discipline** - Enforces beads tracking, aggressive planning, and agent communication
 
 ## Installation
 
@@ -96,6 +98,7 @@ bd --version
 
 | Tool                           | Description                                                              |
 | ------------------------------ | ------------------------------------------------------------------------ |
+| `swarm_init`                   | Check tool availability, report degraded features                        |
 | `swarm_decompose`              | Generate decomposition prompt, optionally queries CASS for similar tasks |
 | `swarm_validate_decomposition` | Validate decomposition response, detect instruction conflicts            |
 | `swarm_status`                 | Get swarm status by epic ID                                              |

package/dist/index.js

@@ -12890,12 +12890,12 @@ async function commandExists(cmd) {
     return false;
   }
 }
-async function urlReachable(url2, timeoutMs = 1000) {
+async function urlReachable(url2, timeoutMs = 2000) {
   try {
     const controller = new AbortController;
     const timeout = setTimeout(() => controller.abort(), timeoutMs);
     const response = await fetch(url2, {
-      method: "HEAD",
+      method: "GET",
       signal: controller.signal
     });
     clearTimeout(timeout);

package/dist/plugin.js

@@ -12890,12 +12890,12 @@ async function commandExists(cmd) {
     return false;
   }
 }
-async function urlReachable(url2, timeoutMs = 1000) {
+async function urlReachable(url2, timeoutMs = 2000) {
   try {
     const controller = new AbortController;
     const timeout = setTimeout(() => controller.abort(), timeoutMs);
     const response = await fetch(url2, {
-      method: "HEAD",
+      method: "GET",
       signal: controller.signal
     });
     clearTimeout(timeout);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "dist/index.js",

package/src/tool-availability.ts

@@ -55,14 +55,15 @@ async function commandExists(cmd: string): Promise<boolean> {
  */
 async function urlReachable(
   url: string,
-  timeoutMs: number = 1000,
+  timeoutMs: number = 2000,
 ): Promise<boolean> {
   try {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), timeoutMs);
 
+    // Use GET instead of HEAD - some servers don't support HEAD
     const response = await fetch(url, {
-      method: "HEAD",
+      method: "GET",
       signal: controller.signal,
     });
 

package/Dockerfile

@@ -1,30 +0,0 @@
-# Test runner container for opencode-swarm-plugin integration tests
-FROM oven/bun:latest
-
-# Install git (required for beads) and curl (for healthchecks)
-RUN apt-get update && apt-get install -y \
-    git \
-    curl \
-    && rm -rf /var/lib/apt/lists/*
-
-# Download bd CLI (beads issue tracker) for linux/amd64
-ARG BD_VERSION=0.2.8
-RUN curl -fsSL "https://github.com/beads-ai/beads/releases/download/v${BD_VERSION}/bd-linux-amd64" \
-    -o /usr/local/bin/bd \
-    && chmod +x /usr/local/bin/bd
-
-WORKDIR /app
-
-# Copy package files and install dependencies
-COPY package.json bun.lock* ./
-RUN bun install --frozen-lockfile
-
-# Copy source code
-COPY . .
-
-# Copy entrypoint script
-COPY scripts/docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
-RUN chmod +x /usr/local/bin/docker-entrypoint.sh
-
-ENTRYPOINT ["docker-entrypoint.sh"]
-CMD ["bun", "run", "test:integration"]

package/docker/agent-mail/Dockerfile

@@ -1,23 +0,0 @@
-FROM python:3.11-slim
-
-WORKDIR /app
-
-# Install dependencies
-COPY requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt
-
-# Copy server code
-COPY server.py .
-
-# Create data directory for SQLite
-RUN mkdir -p /data
-
-# Expose port
-EXPOSE 8765
-
-# Health check
-HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \
-    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8765/health/liveness')" || exit 1
-
-# Run server
-CMD ["uvicorn", "server:app", "--host", "0.0.0.0", "--port", "8765"]

package/docker/agent-mail/requirements.txt

@@ -1,3 +0,0 @@
-fastapi>=0.109.0
-uvicorn[standard]>=0.27.0
-pydantic>=2.5.0

package/docker/agent-mail/server.py

@@ -1,879 +0,0 @@
-"""
-Minimal Agent Mail Server for Integration Testing
-
-A lightweight MCP-compatible server that provides multi-agent coordination
-capabilities: messaging, file reservations, and project management.
-
-This is NOT the production Agent Mail server - it's a minimal implementation
-for testing the opencode-swarm-plugin MCP client.
-"""
-
-import random
-import sqlite3
-import uuid
-from contextlib import contextmanager
-from datetime import datetime, timedelta, timezone
-from pathlib import Path
-from typing import Any
-
-from fastapi import FastAPI, HTTPException
-from fastapi.responses import JSONResponse
-from pydantic import BaseModel
-
-# =============================================================================
-# Configuration
-# =============================================================================
-
-DB_PATH = Path("/data/agentmail.db")
-
-# Agent name generation wordlists
-ADJECTIVES = [
-    "Blue", "Red", "Green", "Golden", "Silver", "Crystal", "Shadow", "Bright",
-    "Swift", "Silent", "Bold", "Calm", "Wild", "Noble", "Frost", "Storm",
-    "Dawn", "Dusk", "Iron", "Copper", "Azure", "Crimson", "Amber", "Jade",
-    "Coral", "Misty", "Sunny", "Lunar", "Solar", "Cosmic", "Terra", "Aqua",
-]
-
-NOUNS = [
-    "Lake", "Stone", "River", "Mountain", "Forest", "Valley", "Meadow", "Peak",
-    "Canyon", "Desert", "Ocean", "Island", "Prairie", "Grove", "Creek", "Ridge",
-    "Harbor", "Cliff", "Glacier", "Dune", "Marsh", "Brook", "Hill", "Plain",
-    "Bay", "Cape", "Delta", "Fjord", "Mesa", "Plateau", "Reef", "Tundra",
-]
-
-# =============================================================================
-# Database Setup
-# =============================================================================
-
-def init_db():
-    """Initialize SQLite database with required tables."""
-    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
-    
-    conn = sqlite3.connect(str(DB_PATH))
-    conn.row_factory = sqlite3.Row
-    
-    conn.executescript("""
-        -- Projects table
-        CREATE TABLE IF NOT EXISTS projects (
-            id INTEGER PRIMARY KEY AUTOINCREMENT,
-            slug TEXT UNIQUE NOT NULL,
-            human_key TEXT NOT NULL,
-            created_at TEXT NOT NULL DEFAULT (datetime('now'))
-        );
-        
-        -- Agents table
-        CREATE TABLE IF NOT EXISTS agents (
-            id INTEGER PRIMARY KEY AUTOINCREMENT,
-            name TEXT NOT NULL,
-            program TEXT NOT NULL,
-            model TEXT NOT NULL,
-            task_description TEXT,
-            inception_ts TEXT NOT NULL DEFAULT (datetime('now')),
-            last_active_ts TEXT NOT NULL DEFAULT (datetime('now')),
-            project_id INTEGER NOT NULL,
-            FOREIGN KEY (project_id) REFERENCES projects(id),
-            UNIQUE (name, project_id)
-        );
-        
-        -- Messages table
-        CREATE TABLE IF NOT EXISTS messages (
-            id INTEGER PRIMARY KEY AUTOINCREMENT,
-            project_id INTEGER NOT NULL,
-            sender_id INTEGER NOT NULL,
-            subject TEXT NOT NULL,
-            body_md TEXT,
-            thread_id TEXT,
-            importance TEXT DEFAULT 'normal',
-            ack_required INTEGER DEFAULT 0,
-            kind TEXT DEFAULT 'message',
-            created_ts TEXT NOT NULL DEFAULT (datetime('now')),
-            FOREIGN KEY (project_id) REFERENCES projects(id),
-            FOREIGN KEY (sender_id) REFERENCES agents(id)
-        );
-        
-        -- Message recipients table (many-to-many)
-        CREATE TABLE IF NOT EXISTS message_recipients (
-            message_id INTEGER NOT NULL,
-            agent_id INTEGER NOT NULL,
-            read_at TEXT,
-            acked_at TEXT,
-            PRIMARY KEY (message_id, agent_id),
-            FOREIGN KEY (message_id) REFERENCES messages(id),
-            FOREIGN KEY (agent_id) REFERENCES agents(id)
-        );
-        
-        -- File reservations table
-        CREATE TABLE IF NOT EXISTS file_reservations (
-            id INTEGER PRIMARY KEY AUTOINCREMENT,
-            project_id INTEGER NOT NULL,
-            agent_id INTEGER NOT NULL,
-            path_pattern TEXT NOT NULL,
-            exclusive INTEGER DEFAULT 1,
-            reason TEXT,
-            created_ts TEXT NOT NULL DEFAULT (datetime('now')),
-            expires_ts TEXT NOT NULL,
-            FOREIGN KEY (project_id) REFERENCES projects(id),
-            FOREIGN KEY (agent_id) REFERENCES agents(id)
-        );
-        
-        -- Full-text search for messages
-        CREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(
-            subject, body_md, content='messages', content_rowid='id'
-        );
-        
-        -- Triggers to keep FTS in sync
-        CREATE TRIGGER IF NOT EXISTS messages_ai AFTER INSERT ON messages BEGIN
-            INSERT INTO messages_fts(rowid, subject, body_md) 
-            VALUES (new.id, new.subject, new.body_md);
-        END;
-        
-        CREATE TRIGGER IF NOT EXISTS messages_ad AFTER DELETE ON messages BEGIN
-            INSERT INTO messages_fts(messages_fts, rowid, subject, body_md) 
-            VALUES ('delete', old.id, old.subject, old.body_md);
-        END;
-        
-        CREATE TRIGGER IF NOT EXISTS messages_au AFTER UPDATE ON messages BEGIN
-            INSERT INTO messages_fts(messages_fts, rowid, subject, body_md) 
-            VALUES ('delete', old.id, old.subject, old.body_md);
-            INSERT INTO messages_fts(rowid, subject, body_md) 
-            VALUES (new.id, new.subject, new.body_md);
-        END;
-    """)
-    
-    conn.commit()
-    conn.close()
-
-
-@contextmanager
-def get_db():
-    """Get database connection with row factory."""
-    conn = sqlite3.connect(str(DB_PATH))
-    conn.row_factory = sqlite3.Row
-    try:
-        yield conn
-        conn.commit()
-    finally:
-        conn.close()
-
-
-def generate_agent_name() -> str:
-    """Generate a random adjective+noun agent name."""
-    return f"{random.choice(ADJECTIVES)}{random.choice(NOUNS)}"
-
-
-def generate_slug(human_key: str) -> str:
-    """Generate a URL-safe slug from a human key."""
-    # Simple slug: replace path separators and special chars
-    slug = human_key.replace("/", "_").replace("\\", "_").replace(" ", "_")
-    slug = "".join(c for c in slug if c.isalnum() or c == "_")
-    return slug.lower()[:64]
-
-
-def now_iso() -> str:
-    """Get current time in ISO format."""
-    return datetime.now(timezone.utc).isoformat()
-
-
-# =============================================================================
-# FastAPI App
-# =============================================================================
-
-app = FastAPI(title="Agent Mail Test Server", version="0.1.0")
-
-
-@app.on_event("startup")
-async def startup():
-    """Initialize database on startup."""
-    init_db()
-
-
-# =============================================================================
-# Health Endpoints
-# =============================================================================
-
-@app.get("/health/liveness")
-async def health_liveness():
-    """Liveness check for container health."""
-    return {"status": "ok", "timestamp": now_iso()}
-
-
-@app.get("/health/readiness")
-async def health_readiness():
-    """Readiness check - verify database is accessible."""
-    try:
-        with get_db() as conn:
-            conn.execute("SELECT 1")
-        return {"status": "ready", "timestamp": now_iso()}
-    except Exception as e:
-        raise HTTPException(status_code=503, detail=str(e))
-
-
-# =============================================================================
-# MCP JSON-RPC Endpoint
-# =============================================================================
-
-class MCPRequest(BaseModel):
-    """MCP JSON-RPC request format."""
-    jsonrpc: str = "2.0"
-    id: str
-    method: str
-    params: dict[str, Any] = {}
-
-
-class MCPError(BaseModel):
-    """MCP JSON-RPC error format."""
-    code: int
-    message: str
-    data: Any = None
-
-
-class MCPResponse(BaseModel):
-    """MCP JSON-RPC response format."""
-    jsonrpc: str = "2.0"
-    id: str
-    result: Any = None
-    error: MCPError | None = None
-
-
-@app.post("/mcp/")
-async def mcp_endpoint(request: MCPRequest):
-    """
-    MCP JSON-RPC endpoint.
-    
-    Handles tools/call method for Agent Mail operations.
-    """
-    if request.method != "tools/call":
-        return MCPResponse(
-            id=request.id,
-            error=MCPError(
-                code=-32601,
-                message=f"Method not found: {request.method}",
-            )
-        )
-    
-    tool_name = request.params.get("name", "")
-    arguments = request.params.get("arguments", {})
-    
-    try:
-        result = await dispatch_tool(tool_name, arguments)
-        return MCPResponse(id=request.id, result=result)
-    except ValueError as e:
-        return MCPResponse(
-            id=request.id,
-            error=MCPError(code=-32602, message=str(e))
-        )
-    except Exception as e:
-        return MCPResponse(
-            id=request.id,
-            error=MCPError(code=-32000, message=str(e))
-        )
-
-
-# =============================================================================
-# Tool Dispatcher
-# =============================================================================
-
-async def dispatch_tool(name: str, args: dict[str, Any]) -> Any:
-    """Dispatch tool call to appropriate handler."""
-    tools = {
-        "ensure_project": tool_ensure_project,
-        "register_agent": tool_register_agent,
-        "send_message": tool_send_message,
-        "fetch_inbox": tool_fetch_inbox,
-        "mark_message_read": tool_mark_message_read,
-        "summarize_thread": tool_summarize_thread,
-        "file_reservation_paths": tool_file_reservation_paths,
-        "release_file_reservations": tool_release_file_reservations,
-        "acknowledge_message": tool_acknowledge_message,
-        "search_messages": tool_search_messages,
-    }
-    
-    handler = tools.get(name)
-    if not handler:
-        raise ValueError(f"Unknown tool: {name}")
-    
-    return await handler(args)
-
-
-# =============================================================================
-# Tool Implementations
-# =============================================================================
-
-async def tool_ensure_project(args: dict[str, Any]) -> dict:
-    """Create or get a project by human_key."""
-    human_key = args.get("human_key")
-    if not human_key:
-        raise ValueError("human_key is required")
-    
-    slug = generate_slug(human_key)
-    
-    with get_db() as conn:
-        # Try to find existing project
-        row = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (human_key,)
-        ).fetchone()
-        
-        if row:
-            return dict(row)
-        
-        # Create new project
-        cursor = conn.execute(
-            "INSERT INTO projects (slug, human_key, created_at) VALUES (?, ?, ?)",
-            (slug, human_key, now_iso())
-        )
-        project_id = cursor.lastrowid
-        
-        row = conn.execute(
-            "SELECT * FROM projects WHERE id = ?",
-            (project_id,)
-        ).fetchone()
-        
-        return dict(row)
-
-
-async def tool_register_agent(args: dict[str, Any]) -> dict:
-    """Register an agent with a project."""
-    project_key = args.get("project_key")
-    program = args.get("program", "unknown")
-    model = args.get("model", "unknown")
-    name = args.get("name")
-    task_description = args.get("task_description", "")
-    
-    if not project_key:
-        raise ValueError("project_key is required")
-    
-    with get_db() as conn:
-        # Get project
-        project = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (project_key,)
-        ).fetchone()
-        
-        if not project:
-            raise ValueError(f"Project not found: {project_key}")
-        
-        project_id = project["id"]
-        
-        # Generate name if not provided
-        if not name:
-            # Keep trying until we get a unique name
-            for _ in range(100):
-                name = generate_agent_name()
-                existing = conn.execute(
-                    "SELECT id FROM agents WHERE name = ? AND project_id = ?",
-                    (name, project_id)
-                ).fetchone()
-                if not existing:
-                    break
-            else:
-                name = f"{generate_agent_name()}_{uuid.uuid4().hex[:4]}"
-        
-        # Check if agent already exists
-        existing = conn.execute(
-            "SELECT * FROM agents WHERE name = ? AND project_id = ?",
-            (name, project_id)
-        ).fetchone()
-        
-        if existing:
-            # Update last_active_ts
-            conn.execute(
-                "UPDATE agents SET last_active_ts = ? WHERE id = ?",
-                (now_iso(), existing["id"])
-            )
-            return dict(existing)
-        
-        # Create new agent
-        now = now_iso()
-        cursor = conn.execute(
-            """INSERT INTO agents 
-               (name, program, model, task_description, inception_ts, last_active_ts, project_id)
-               VALUES (?, ?, ?, ?, ?, ?, ?)""",
-            (name, program, model, task_description, now, now, project_id)
-        )
-        agent_id = cursor.lastrowid
-        
-        row = conn.execute(
-            "SELECT * FROM agents WHERE id = ?",
-            (agent_id,)
-        ).fetchone()
-        
-        return dict(row)
-
-
-async def tool_send_message(args: dict[str, Any]) -> dict:
-    """Send a message to other agents."""
-    project_key = args.get("project_key")
-    sender_name = args.get("sender_name")
-    to = args.get("to", [])
-    subject = args.get("subject", "")
-    body_md = args.get("body_md", "")
-    thread_id = args.get("thread_id")
-    importance = args.get("importance", "normal")
-    ack_required = args.get("ack_required", False)
-    
-    if not project_key:
-        raise ValueError("project_key is required")
-    if not sender_name:
-        raise ValueError("sender_name is required")
-    if not to:
-        raise ValueError("to is required (list of recipient names)")
-    
-    with get_db() as conn:
-        # Get project
-        project = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (project_key,)
-        ).fetchone()
-        if not project:
-            raise ValueError(f"Project not found: {project_key}")
-        
-        project_id = project["id"]
-        
-        # Get sender agent
-        sender = conn.execute(
-            "SELECT * FROM agents WHERE name = ? AND project_id = ?",
-            (sender_name, project_id)
-        ).fetchone()
-        if not sender:
-            raise ValueError(f"Sender agent not found: {sender_name}")
-        
-        # Create message
-        cursor = conn.execute(
-            """INSERT INTO messages 
-               (project_id, sender_id, subject, body_md, thread_id, importance, ack_required, created_ts)
-               VALUES (?, ?, ?, ?, ?, ?, ?, ?)""",
-            (project_id, sender["id"], subject, body_md, thread_id, importance, 
-             1 if ack_required else 0, now_iso())
-        )
-        message_id = cursor.lastrowid
-        
-        # Add recipients
-        for recipient_name in to:
-            recipient = conn.execute(
-                "SELECT * FROM agents WHERE name = ? AND project_id = ?",
-                (recipient_name, project_id)
-            ).fetchone()
-            
-            if recipient:
-                conn.execute(
-                    "INSERT INTO message_recipients (message_id, agent_id) VALUES (?, ?)",
-                    (message_id, recipient["id"])
-                )
-        
-        return {
-            "id": message_id,
-            "subject": subject,
-            "sent_to": to,
-            "created_ts": now_iso(),
-        }
-
-
-async def tool_fetch_inbox(args: dict[str, Any]) -> list[dict]:
-    """Fetch inbox messages for an agent."""
-    project_key = args.get("project_key")
-    agent_name = args.get("agent_name")
-    limit = args.get("limit", 10)
-    include_bodies = args.get("include_bodies", False)
-    urgent_only = args.get("urgent_only", False)
-    since_ts = args.get("since_ts")
-    
-    if not project_key:
-        raise ValueError("project_key is required")
-    if not agent_name:
-        raise ValueError("agent_name is required")
-    
-    with get_db() as conn:
-        # Get project and agent
-        project = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (project_key,)
-        ).fetchone()
-        if not project:
-            raise ValueError(f"Project not found: {project_key}")
-        
-        agent = conn.execute(
-            "SELECT * FROM agents WHERE name = ? AND project_id = ?",
-            (agent_name, project["id"])
-        ).fetchone()
-        if not agent:
-            raise ValueError(f"Agent not found: {agent_name}")
-        
-        # Build query
-        query = """
-            SELECT m.*, a.name as from_name
-            FROM messages m
-            JOIN message_recipients mr ON m.id = mr.message_id
-            JOIN agents a ON m.sender_id = a.id
-            WHERE mr.agent_id = ?
-        """
-        params: list[Any] = [agent["id"]]
-        
-        if urgent_only:
-            query += " AND m.importance = 'urgent'"
-        
-        if since_ts:
-            query += " AND m.created_ts > ?"
-            params.append(since_ts)
-        
-        query += " ORDER BY m.created_ts DESC LIMIT ?"
-        params.append(limit)
-        
-        rows = conn.execute(query, params).fetchall()
-        
-        messages = []
-        for row in rows:
-            msg = {
-                "id": row["id"],
-                "subject": row["subject"],
-                "from": row["from_name"],
-                "created_ts": row["created_ts"],
-                "importance": row["importance"],
-                "ack_required": bool(row["ack_required"]),
-                "thread_id": row["thread_id"],
-                "kind": row["kind"],
-            }
-            if include_bodies:
-                msg["body_md"] = row["body_md"]
-            messages.append(msg)
-        
-        return messages
-
-
-async def tool_mark_message_read(args: dict[str, Any]) -> dict:
-    """Mark a message as read."""
-    project_key = args.get("project_key")
-    agent_name = args.get("agent_name")
-    message_id = args.get("message_id")
-    
-    if not all([project_key, agent_name, message_id]):
-        raise ValueError("project_key, agent_name, and message_id are required")
-    
-    with get_db() as conn:
-        # Get agent
-        project = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (project_key,)
-        ).fetchone()
-        if not project:
-            raise ValueError(f"Project not found: {project_key}")
-        
-        agent = conn.execute(
-            "SELECT * FROM agents WHERE name = ? AND project_id = ?",
-            (agent_name, project["id"])
-        ).fetchone()
-        if not agent:
-            raise ValueError(f"Agent not found: {agent_name}")
-        
-        # Update read timestamp
-        conn.execute(
-            """UPDATE message_recipients 
-               SET read_at = ? 
-               WHERE message_id = ? AND agent_id = ?""",
-            (now_iso(), message_id, agent["id"])
-        )
-        
-        return {"message_id": message_id, "read_at": now_iso()}
-
-
-async def tool_summarize_thread(args: dict[str, Any]) -> dict:
-    """Summarize a message thread."""
-    project_key = args.get("project_key")
-    thread_id = args.get("thread_id")
-    include_examples = args.get("include_examples", False)
-    
-    if not project_key:
-        raise ValueError("project_key is required")
-    if not thread_id:
-        raise ValueError("thread_id is required")
-    
-    with get_db() as conn:
-        # Get project
-        project = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (project_key,)
-        ).fetchone()
-        if not project:
-            raise ValueError(f"Project not found: {project_key}")
-        
-        # Get messages in thread
-        rows = conn.execute(
-            """SELECT m.*, a.name as from_name
-               FROM messages m
-               JOIN agents a ON m.sender_id = a.id
-               WHERE m.thread_id = ? AND m.project_id = ?
-               ORDER BY m.created_ts ASC""",
-            (thread_id, project["id"])
-        ).fetchall()
-        
-        # Build summary
-        participants = list(set(row["from_name"] for row in rows))
-        
-        # Simple key points extraction (just use subjects for now)
-        key_points = [row["subject"] for row in rows[:5]]
-        
-        # Action items (messages with "urgent" importance)
-        action_items = [
-            row["subject"] for row in rows 
-            if row["importance"] == "urgent"
-        ]
-        
-        result = {
-            "thread_id": thread_id,
-            "summary": {
-                "participants": participants,
-                "key_points": key_points,
-                "action_items": action_items,
-                "total_messages": len(rows),
-            }
-        }
-        
-        if include_examples and rows:
-            examples = []
-            for row in rows[:3]:
-                examples.append({
-                    "id": row["id"],
-                    "subject": row["subject"],
-                    "from": row["from_name"],
-                    "body_md": row["body_md"],
-                })
-            result["examples"] = examples
-        
-        return result
-
-
-async def tool_file_reservation_paths(args: dict[str, Any]) -> dict:
-    """Reserve file paths for exclusive editing."""
-    project_key = args.get("project_key")
-    agent_name = args.get("agent_name")
-    paths = args.get("paths", [])
-    ttl_seconds = args.get("ttl_seconds", 3600)
-    exclusive = args.get("exclusive", True)
-    reason = args.get("reason", "")
-    
-    if not project_key:
-        raise ValueError("project_key is required")
-    if not agent_name:
-        raise ValueError("agent_name is required")
-    if not paths:
-        raise ValueError("paths is required (list of path patterns)")
-    
-    with get_db() as conn:
-        # Get project and agent
-        project = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (project_key,)
-        ).fetchone()
-        if not project:
-            raise ValueError(f"Project not found: {project_key}")
-        
-        agent = conn.execute(
-            "SELECT * FROM agents WHERE name = ? AND project_id = ?",
-            (agent_name, project["id"])
-        ).fetchone()
-        if not agent:
-            raise ValueError(f"Agent not found: {agent_name}")
-        
-        project_id = project["id"]
-        agent_id = agent["id"]
-        
-        # Check for conflicts with existing reservations
-        conflicts = []
-        granted = []
-        now = now_iso()
-        expires = (datetime.now(timezone.utc) + timedelta(seconds=ttl_seconds)).isoformat()
-        
-        # Clean up expired reservations first
-        conn.execute(
-            "DELETE FROM file_reservations WHERE expires_ts < ?",
-            (now,)
-        )
-        
-        for path in paths:
-            # Check for conflicting exclusive reservations
-            # Simple matching: exact match or glob patterns
-            conflicting = conn.execute(
-                """SELECT fr.*, a.name as holder_name
-                   FROM file_reservations fr
-                   JOIN agents a ON fr.agent_id = a.id
-                   WHERE fr.project_id = ? 
-                   AND fr.agent_id != ?
-                   AND fr.exclusive = 1
-                   AND (fr.path_pattern = ? OR fr.path_pattern LIKE ? OR ? LIKE fr.path_pattern)""",
-                (project_id, agent_id, path, path.replace("*", "%"), path.replace("*", "%"))
-            ).fetchall()
-            
-            if conflicting:
-                conflicts.append({
-                    "path": path,
-                    "holders": [r["holder_name"] for r in conflicting],
-                })
-            else:
-                # Grant the reservation
-                cursor = conn.execute(
-                    """INSERT INTO file_reservations 
-                       (project_id, agent_id, path_pattern, exclusive, reason, created_ts, expires_ts)
-                       VALUES (?, ?, ?, ?, ?, ?, ?)""",
-                    (project_id, agent_id, path, 1 if exclusive else 0, reason, now, expires)
-                )
-                granted.append({
-                    "id": cursor.lastrowid,
-                    "path_pattern": path,
-                    "exclusive": exclusive,
-                    "reason": reason,
-                    "expires_ts": expires,
-                })
-        
-        return {
-            "granted": granted,
-            "conflicts": conflicts,
-        }
-
-
-async def tool_release_file_reservations(args: dict[str, Any]) -> dict:
-    """Release file reservations."""
-    project_key = args.get("project_key")
-    agent_name = args.get("agent_name")
-    paths = args.get("paths")
-    file_reservation_ids = args.get("file_reservation_ids")
-    
-    if not project_key:
-        raise ValueError("project_key is required")
-    if not agent_name:
-        raise ValueError("agent_name is required")
-    
-    with get_db() as conn:
-        # Get project and agent
-        project = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (project_key,)
-        ).fetchone()
-        if not project:
-            raise ValueError(f"Project not found: {project_key}")
-        
-        agent = conn.execute(
-            "SELECT * FROM agents WHERE name = ? AND project_id = ?",
-            (agent_name, project["id"])
-        ).fetchone()
-        if not agent:
-            raise ValueError(f"Agent not found: {agent_name}")
-        
-        # Build delete query
-        if file_reservation_ids:
-            # Delete by IDs
-            placeholders = ",".join("?" * len(file_reservation_ids))
-            cursor = conn.execute(
-                f"""DELETE FROM file_reservations 
-                    WHERE id IN ({placeholders}) AND agent_id = ?""",
-                (*file_reservation_ids, agent["id"])
-            )
-        elif paths:
-            # Delete by paths
-            placeholders = ",".join("?" * len(paths))
-            cursor = conn.execute(
-                f"""DELETE FROM file_reservations 
-                    WHERE path_pattern IN ({placeholders}) AND agent_id = ?""",
-                (*paths, agent["id"])
-            )
-        else:
-            # Delete all for this agent
-            cursor = conn.execute(
-                "DELETE FROM file_reservations WHERE agent_id = ?",
-                (agent["id"],)
-            )
-        
-        return {
-            "released": cursor.rowcount,
-            "released_at": now_iso(),
-        }
-
-
-async def tool_acknowledge_message(args: dict[str, Any]) -> dict:
-    """Acknowledge a message."""
-    project_key = args.get("project_key")
-    agent_name = args.get("agent_name")
-    message_id = args.get("message_id")
-    
-    if not all([project_key, agent_name, message_id]):
-        raise ValueError("project_key, agent_name, and message_id are required")
-    
-    with get_db() as conn:
-        # Get agent
-        project = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (project_key,)
-        ).fetchone()
-        if not project:
-            raise ValueError(f"Project not found: {project_key}")
-        
-        agent = conn.execute(
-            "SELECT * FROM agents WHERE name = ? AND project_id = ?",
-            (agent_name, project["id"])
-        ).fetchone()
-        if not agent:
-            raise ValueError(f"Agent not found: {agent_name}")
-        
-        # Update ack timestamp
-        now = now_iso()
-        conn.execute(
-            """UPDATE message_recipients 
-               SET acked_at = ? 
-               WHERE message_id = ? AND agent_id = ?""",
-            (now, message_id, agent["id"])
-        )
-        
-        return {"message_id": message_id, "acked_at": now}
-
-
-async def tool_search_messages(args: dict[str, Any]) -> list[dict]:
-    """Search messages using FTS5."""
-    project_key = args.get("project_key")
-    query = args.get("query", "")
-    limit = args.get("limit", 20)
-    
-    if not project_key:
-        raise ValueError("project_key is required")
-    if not query:
-        raise ValueError("query is required")
-    
-    with get_db() as conn:
-        # Get project
-        project = conn.execute(
-            "SELECT * FROM projects WHERE human_key = ?",
-            (project_key,)
-        ).fetchone()
-        if not project:
-            raise ValueError(f"Project not found: {project_key}")
-        
-        # Search using FTS5
-        rows = conn.execute(
-            """SELECT m.*, a.name as from_name
-               FROM messages m
-               JOIN messages_fts fts ON m.id = fts.rowid
-               JOIN agents a ON m.sender_id = a.id
-               WHERE m.project_id = ? AND messages_fts MATCH ?
-               ORDER BY rank
-               LIMIT ?""",
-            (project["id"], query, limit)
-        ).fetchall()
-        
-        return [
-            {
-                "id": row["id"],
-                "subject": row["subject"],
-                "from": row["from_name"],
-                "created_ts": row["created_ts"],
-                "importance": row["importance"],
-                "thread_id": row["thread_id"],
-            }
-            for row in rows
-        ]
-
-
-# =============================================================================
-# Main
-# =============================================================================
-
-if __name__ == "__main__":
-    import uvicorn
-    uvicorn.run(app, host="0.0.0.0", port=8765)

package/docker-compose.yml

@@ -1,45 +0,0 @@
-# Docker Compose for opencode-swarm-plugin integration tests
-# Services: agent-mail (FastAPI) + test-runner (Bun)
-
-services:
-  agent-mail:
-    build:
-      context: ./docker/agent-mail
-      dockerfile: Dockerfile
-    ports:
-      - "8765:8765"
-    environment:
-      - AGENT_MAIL_HOST=0.0.0.0
-      - AGENT_MAIL_PORT=8765
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8765/health/liveness"]
-      interval: 5s
-      timeout: 3s
-      retries: 10
-      start_period: 5s
-    networks:
-      - test-network
-
-  test-runner:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    depends_on:
-      agent-mail:
-        condition: service_healthy
-    environment:
-      - AGENT_MAIL_URL=http://agent-mail:8765
-      - GIT_AUTHOR_NAME=Test Runner
-      - GIT_AUTHOR_EMAIL=test@example.com
-      - GIT_COMMITTER_NAME=Test Runner
-      - GIT_COMMITTER_EMAIL=test@example.com
-    volumes:
-      # Mount source for faster iteration (optional - comment out for clean builds)
-      - ./src:/app/src:ro
-      - ./tests:/app/tests:ro
-    networks:
-      - test-network
-
-networks:
-  test-network:
-    driver: bridge

package/scripts/docker-entrypoint.sh

@@ -1,54 +0,0 @@
-#!/bin/bash
-set -e
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-log() { echo -e "${GREEN}[entrypoint]${NC} $1"; }
-warn() { echo -e "${YELLOW}[entrypoint]${NC} $1"; }
-error() { echo -e "${RED}[entrypoint]${NC} $1"; }
-
-# Initialize git repo if not present (beads requires git)
-if [ ! -d ".git" ]; then
-    log "Initializing git repository..."
-    git init
-    git config user.email "test@example.com"
-    git config user.name "Test Runner"
-    git add -A
-    git commit -m "Initial commit for test environment" --allow-empty
-fi
-
-# Initialize beads if not present
-if [ ! -d ".beads" ]; then
-    log "Initializing beads..."
-    bd init --name "test-project" || warn "beads init failed (may already exist)"
-fi
-
-# Wait for agent-mail to be healthy
-AGENT_MAIL_URL="${AGENT_MAIL_URL:-http://agent-mail:8765}"
-MAX_RETRIES=30
-RETRY_COUNT=0
-
-log "Waiting for agent-mail at ${AGENT_MAIL_URL}..."
-
-while [ $RETRY_COUNT -lt $MAX_RETRIES ]; do
-    if curl -sf "${AGENT_MAIL_URL}/health/liveness" > /dev/null 2>&1; then
-        log "agent-mail is healthy!"
-        break
-    fi
-    RETRY_COUNT=$((RETRY_COUNT + 1))
-    if [ $RETRY_COUNT -eq $MAX_RETRIES ]; then
-        error "agent-mail failed to become healthy after ${MAX_RETRIES} attempts"
-        exit 1
-    fi
-    warn "Waiting for agent-mail... (attempt ${RETRY_COUNT}/${MAX_RETRIES})"
-    sleep 1
-done
-
-log "Starting integration tests..."
-
-# Execute the command passed to the container
-exec "$@"