Development

git clone https://github.com/metal0/mailpilot.git
cd mailpilot
pnpm install

mailpilot/
├── src/                  # Backend source code
│   ├── server/          # HTTP server and API
│   ├── services/        # Core email processing logic
│   ├── lib/             # Shared utilities
│   └── types/           # TypeScript type definitions
├── dashboard/           # Svelte frontend
├── docs-site/           # Documentation site (fumadocs)
├── docs/                # Developer documentation
├── scripts/             # Utility scripts
└── tests/               # E2E tests

# Backend development
pnpm dev                 # Start with hot reload

# Frontend dashboard
cd dashboard
pnpm dev                 # Runs on port 8085

# Documentation site
cd docs-site
pnpm dev                 # Runs on port 3001

# Testing
pnpm test                # Run E2E tests
pnpm test:unit           # Run unit tests

# Build
pnpm build               # Build backend and dashboard
pnpm build:docker        # Build Docker image

/**
 * Process an email using the configured LLM provider
 * @param email - The email to process
 * @param config - Account configuration
 * @returns Classified actions
 */
async function processEmail(
  email: IMAPEmail,
  config: AccountConfig
): Promise<ClassifiedActions> {
  try {
    // Build prompt from email content
    const prompt = buildPrompt(email, config);

    // Call LLM
    const response = await llm.classify(prompt);

    // Parse and validate actions
    return validateActions(response);
  } catch (error) {
    logger.error('Email processing failed', { error });
    throw new ProcessingError('Classification failed', { cause: error });
  }
}