// Create a bug report with priority
await tools["beads_create"]({
  title: "Fix login redirect loop",
  type: "bug",
  priority: 1,
  description: "Users stuck in redirect after OAuth callback",
});

// Create epic and all subtasks atomically (with rollback hints on failure)
const result = await tools["beads_create_epic"]({
  epic_title: "Implement user dashboard",
  epic_description: "New dashboard with metrics and activity feed",
  subtasks: [
    {
      title: "Create dashboard layout",
      priority: 2,
      files: ["src/components/Dashboard.tsx"],
    },
    {
      title: "Add metrics API endpoint",
      priority: 2,
      files: ["src/api/metrics.ts"],
    },
    {
      title: "Build activity feed component",
      priority: 3,
      files: ["src/components/ActivityFeed.tsx"],
    },
  ],
});

// 1. Initialize session
await tools["agentmail_init"]({
  project_path: "/Users/you/project",
  task_description: "Working on auth refactor",
});
// Returns: { agent: { name: "BlueLake", ... } }

// 2. Reserve files before editing
await tools["agentmail_reserve"]({
  paths: ["src/auth/**", "src/middleware/auth.ts"],
  reason: "bd-abc123: Auth refactor",
  ttl_seconds: 3600,
});

// 3. Check inbox (bodies excluded by default)
const messages = await tools["agentmail_inbox"]({ limit: 5 });

// 4. Send status update to other agents
await tools["agentmail_send"]({
  to: ["RedStone", "GreenCastle"],
  subject: "Auth refactor complete",
  body: "Finished updating the auth middleware. Ready for review.",
  thread_id: "bd-abc123",
});

// 5. Release reservations when done
await tools["agentmail_release"]({});

// 1. Create epic for the work
const epic = await tools["beads_create_epic"]({
  epic_title: "Add export feature",
  subtasks: [
    { title: "Export to CSV", files: ["src/export/csv.ts"] },
    { title: "Export to JSON", files: ["src/export/json.ts"] },
    { title: "Export to PDF", files: ["src/export/pdf.ts"] },
  ],
});

// 2. Each parallel agent reserves its files
// Agent 1 (BlueLake):
await tools["agentmail_reserve"]({
  paths: ["src/export/csv.ts"],
  reason: `${epic.subtasks[0].id}: Export to CSV`,
});

// 3. Agents communicate via thread
await tools["agentmail_send"]({
  to: ["Coordinator"],
  subject: "CSV export complete",
  body: "Implemented CSV export with streaming support.",
  thread_id: epic.epic.id,
});

// 4. Coordinator uses summarize_thread (not fetch all)
const summary = await tools["agentmail_summarize_thread"]({
  thread_id: epic.epic.id,
  include_examples: true,
});

// WRONG: This can dump thousands of tokens into context
const messages = await tools["agentmail_inbox"]({
  limit: 20,
  include_bodies: true, // Plugin prevents this
});

// RIGHT: Headers only, then fetch specific messages
const headers = await tools["agentmail_inbox"]({ limit: 5 });
const importantMessage = await tools["agentmail_read_message"]({
  message_id: headers[0].id,
});

// BEST: Summarize threads instead of fetching all messages
const summary = await tools["agentmail_summarize_thread"]({
  thread_id: "bd-abc123",
});

import {
  BeadError,
  BeadValidationError,
  AgentMailError,
  AgentMailNotInitializedError,
  FileReservationConflictError,
} from "opencode-swarm-plugin";

try {
  await tools["agentmail_reserve"]({ paths: ["src/index.ts"] });
} catch (error) {
  if (error instanceof FileReservationConflictError) {
    console.log("Conflicts:", error.conflicts);
    // [{ path: "src/index.ts", holders: ["RedStone"] }]
  }
}