swarmmail_init({
  project_path: "/Users/joel/projects/my-app",
  task_description: "bd-123.2: Implementing OAuth service"
})
// Returns: { agent_name: "BlueLake", project_key: "/Users/joel/projects/my-app" }

// Progress update to coordinator
swarmmail_send({
  to: ["coordinator"],
  subject: "Progress: bd-123.2",
  body: "Schema defined, starting service layer. ETA 20min.",
  thread_id: "bd-123"
})

// Blocker notification
swarmmail_send({
  to: ["coordinator"],
  subject: "BLOCKED: bd-123.2 needs database schema",
  body: "Can't proceed without db migration from bd-123.1",
  importance: "high",
  thread_id: "bd-123"
})

swarmmail_inbox({ limit: 5 })
// Returns headers only (no bodies)

swarmmail_read_message({ message_id: 42 })
// Returns: { id: 42, subject: "...", body: "...", from: "...", ... }

swarmmail_reserve({
  paths: ["src/auth/**", "src/lib/jwt.ts"],
  reason: "bd-123.2: Auth service implementation",
  ttl_seconds: 3600
})
// Returns: { granted: [{ id: 1, path_pattern: "src/auth/**", ... }] }

// Release all reservations for current agent
swarmmail_release()

// Release specific paths
swarmmail_release({ paths: ["src/auth/**"] })

swarm_init({ project_path: "/Users/joel/projects/my-app" })
// Returns: { hive_available: true, swarmmail_available: true, ... }

swarm_select_strategy({
  task: "Add OAuth authentication with refresh tokens"
})
// Returns: { strategy: "feature-based", rationale: "...", confidence: 0.85 }

swarm_decompose({
  task: "Add OAuth authentication",
  max_subtasks: 5,
  query_cass: true
})
// Returns prompt string with CASS context

swarm_validate_decomposition({
  response: `{ "epic": {...}, "subtasks": [...] }`
})
// Returns: { valid: true, data: {...} } or { valid: false, errors: [...] }

swarm_plan_prompt({
  task: "Add OAuth authentication",
  strategy: "feature-based",
  max_subtasks: 5
})

swarm_subtask_prompt({
  agent_name: "BlueLake",
  cell_id: "bd-123.2",
  epic_id: "bd-123",
  subtask_title: "Implement OAuth flow",
  files: ["src/auth/oauth.ts", "src/auth/tokens.ts"],
  shared_context: "Use JWT with 5min refresh buffer"
})
// Returns full worker agent prompt

swarm_spawn_subtask({
  cell_id: "bd-123.2",
  epic_id: "bd-123",
  subtask_title: "Implement OAuth flow",
  files: ["src/auth/oauth.ts"]
})
// Returns: { prompt: "...", files: [...] }

swarm_status({
  epic_id: "bd-123",
  project_key: "/Users/joel/projects/my-app"
})
// Returns: { total: 5, completed: 3, in_progress: 1, blocked: 1 }

swarm_progress({
  project_key: "/Users/joel/projects/my-app",
  agent_name: "BlueLake",
  cell_id: "bd-123.2",
  status: "in_progress",
  message: "Schema defined, starting service layer",
  progress_percent: 40,
  files_touched: ["src/auth/schema.ts"]
})

swarm_complete({
  project_key: "/Users/joel/projects/my-app",
  agent_name: "BlueLake",
  cell_id: "bd-123.2",
  summary: "OAuth flow implemented with JWT strategy",
  files_touched: ["src/auth/oauth.ts", "src/auth/tokens.ts"],
  evaluation: "Completed successfully, added unit tests"
})
// Auto-releases reservations, records learning signals

swarm_record_outcome({
  cell_id: "bd-123.2",
  duration_ms: 1200000, // 20 minutes
  success: true,
  error_count: 0,
  retry_count: 0,
  files_touched: ["src/auth/oauth.ts"],
  strategy: "feature-based"
})

swarm_evaluation_prompt({
  cell_id: "bd-123.2",
  subtask_title: "Implement OAuth flow",
  files_touched: ["src/auth/oauth.ts"]
})
// Returns prompt asking agent to self-evaluate

// 1. Initialize swarm
swarm_init({ project_path: "/my/project" })

// 2. Decompose task
const prompt = swarm_decompose({
  task: "Add OAuth authentication",
  max_subtasks: 5,
  query_cass: true
})

// Agent responds with CellTree JSON

// 3. Validate decomposition
const validation = swarm_validate_decomposition({
  response: agentResponse
})

// 4. Create epic + subtasks
hive_create_epic({
  epic_title: "User Authentication",
  subtasks: validation.data.subtasks
})

// 5. Each worker agent:
swarmmail_init({ project_path: "/my/project" })
swarmmail_reserve({
  paths: ["src/auth/**"],
  reason: "bd-123.2: Auth service"
})
// ... do work following TDD (Red → Green → Refactor) ...
swarm_complete({
  project_key: "/my/project",
  agent_name: "BlueLake",
  cell_id: "bd-123.2",
  summary: "OAuth flow implemented",
  files_touched: ["src/auth/oauth.ts"]
})