feat: Add multi-provider AI support

.env.example

@@ -67,8 +67,37 @@ VITE_APP_NAME="${APP_NAME}"
 # ===========================================
 # AI Provider Configuration
 # ===========================================
-# Get your API key from: https://console.anthropic.com/
+# Configure at least one AI provider to use PlanForge.
+# Only providers with configured API keys will appear in the UI.
+
+# Anthropic (Claude) - Recommended
+# Get your key from: https://console.anthropic.com/
 ANTHROPIC_API_KEY=
 
-# Optional: OpenAI for alternative provider
+# OpenAI (GPT)
+# Get your key from: https://platform.openai.com/api-keys
 # OPENAI_API_KEY=
+
+# Google Gemini
+# Get your key from: https://aistudio.google.com/apikey
+# GEMINI_API_KEY=
+
+# Mistral AI
+# Get your key from: https://console.mistral.ai/api-keys
+# MISTRAL_API_KEY=
+
+# Groq (Fast inference)
+# Get your key from: https://console.groq.com/keys
+# GROQ_API_KEY=
+
+# DeepSeek
+# Get your key from: https://platform.deepseek.com/api_keys
+# DEEPSEEK_API_KEY=
+
+# OpenRouter (Access multiple providers with one key)
+# Get your key from: https://openrouter.ai/keys
+# OPENROUTER_API_KEY=
+
+# Ollama (Local, self-hosted)
+# No API key needed - just set the URL
+# OLLAMA_URL=http://localhost:11434

app/Enums/AiProvider.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Enums;
+
+use Prism\Prism\Enums\Provider;
+
+enum AiProvider: string
+{
+    case Anthropic = 'anthropic';
+    case OpenAI = 'openai';
+    case Gemini = 'gemini';
+    case Mistral = 'mistral';
+    case Groq = 'groq';
+    case DeepSeek = 'deepseek';
+    case Ollama = 'ollama';
+    case OpenRouter = 'openrouter';
+
+    public function toPrismProvider(): Provider
+    {
+        return match ($this) {
+            self::Anthropic => Provider::Anthropic,
+            self::OpenAI => Provider::OpenAI,
+            self::Gemini => Provider::Gemini,
+            self::Mistral => Provider::Mistral,
+            self::Groq => Provider::Groq,
+            self::DeepSeek => Provider::DeepSeek,
+            self::Ollama => Provider::Ollama,
+            self::OpenRouter => Provider::OpenRouter,
+        };
+    }
+
+    public function label(): string
+    {
+        return match ($this) {
+            self::Anthropic => 'Anthropic',
+            self::OpenAI => 'OpenAI',
+            self::Gemini => 'Google Gemini',
+            self::Mistral => 'Mistral AI',
+            self::Groq => 'Groq',
+            self::DeepSeek => 'DeepSeek',
+            self::Ollama => 'Ollama (Local)',
+            self::OpenRouter => 'OpenRouter',
+        };
+    }
+
+    public function configKey(): string
+    {
+        return "prism.providers.{$this->value}.api_key";
+    }
+
+    public function isLocal(): bool
+    {
+        return $this === self::Ollama;
+    }
+}

app/Jobs/Concerns/ResolvesAiProvider.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace App\Jobs\Concerns;
+
+use App\Services\ProviderService;
+use Prism\Prism\Enums\Provider;
+
+trait ResolvesAiProvider
+{
+    protected function resolveProvider(string $provider): Provider
+    {
+        return app(ProviderService::class)->resolveProvider($provider);
+    }
+}

app/Jobs/GeneratePrdJob.php

@@ -17,13 +17,13 @@
 use Illuminate\Queue\InteractsWithQueue;
 use Illuminate\Queue\Middleware\RateLimited;
 use Illuminate\Queue\SerializesModels;
-use Prism\Prism\Enums\Provider;
 use Prism\Prism\Exceptions\PrismRateLimitedException;
 use Prism\Prism\Facades\Prism;
 use Throwable;
 
 class GeneratePrdJob implements ShouldBeUnique, ShouldQueue
 {
+    use Concerns\ResolvesAiProvider;
     use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
 
     public int $tries = 5;
@@ -171,16 +171,4 @@ public function handle(): void
             throw $e;
         }
     }
-
-    private function resolveProvider(string $provider): Provider
-    {
-        return match ($provider) {
-            'anthropic' => Provider::Anthropic,
-            'openai' => Provider::OpenAI,
-            'gemini' => Provider::Gemini,
-            'mistral' => Provider::Mistral,
-            'groq' => Provider::Groq,
-            default => Provider::Anthropic,
-        };
-    }
 }

app/Jobs/GenerateTasksJob.php

@@ -20,14 +20,14 @@
 use Illuminate\Queue\Middleware\RateLimited;
 use Illuminate\Queue\SerializesModels;
 use Illuminate\Support\Facades\DB;
-use Prism\Prism\Enums\Provider;
 use Prism\Prism\Exceptions\PrismRateLimitedException;
 use Prism\Prism\Facades\Prism;
 use Relaticle\Flowforge\Services\Rank;
 use Throwable;
 
 class GenerateTasksJob implements ShouldBeUnique, ShouldQueue
 {
+    use Concerns\ResolvesAiProvider;
     use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
 
     public int $tries = 5;
@@ -268,18 +268,6 @@ private function handleError(Throwable $e, PlanRunStep $step, PlanRun $run): voi
         throw $e;
     }
 
-    private function resolveProvider(string $provider): Provider
-    {
-        return match ($provider) {
-            'anthropic' => Provider::Anthropic,
-            'openai' => Provider::OpenAI,
-            'gemini' => Provider::Gemini,
-            'mistral' => Provider::Mistral,
-            'groq' => Provider::Groq,
-            default => Provider::Anthropic,
-        };
-    }
-
     private function truncate(?string $text, int $length): ?string
     {
         if ($text === null) {

app/Jobs/GenerateTechSpecJob.php

@@ -17,13 +17,13 @@
 use Illuminate\Queue\InteractsWithQueue;
 use Illuminate\Queue\Middleware\RateLimited;
 use Illuminate\Queue\SerializesModels;
-use Prism\Prism\Enums\Provider;
 use Prism\Prism\Exceptions\PrismRateLimitedException;
 use Prism\Prism\Facades\Prism;
 use Throwable;
 
 class GenerateTechSpecJob implements ShouldBeUnique, ShouldQueue
 {
+    use Concerns\ResolvesAiProvider;
     use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
 
     public int $tries = 5;
@@ -184,16 +184,4 @@ public function handle(): void
             throw $e;
         }
     }
-
-    private function resolveProvider(string $provider): Provider
-    {
-        return match ($provider) {
-            'anthropic' => Provider::Anthropic,
-            'openai' => Provider::OpenAI,
-            'gemini' => Provider::Gemini,
-            'mistral' => Provider::Mistral,
-            'groq' => Provider::Groq,
-            default => Provider::Anthropic,
-        };
-    }
 }

app/Livewire/Concerns/ManagesProviderSelection.php

@@ -0,0 +1,122 @@
+<?php
+
+namespace App\Livewire\Concerns;
+
+use App\Enums\AiProvider;
+use App\Services\ProviderService;
+use Livewire\Attributes\Computed;
+
+trait ManagesProviderSelection
+{
+    public string $selectedProvider = '';
+
+    public string $selectedModel = '';
+
+    public bool $useCustomModel = false;
+
+    public string $customModel = '';
+
+    public function updatedSelectedProvider(): void
+    {
+        $provider = AiProvider::tryFrom($this->selectedProvider);
+
+        if ($provider) {
+            $this->selectedModel = $this->providerService()->getDefaultModel($provider) ?? '';
+        }
+
+        $this->useCustomModel = false;
+        $this->customModel = '';
+    }
+
+    public function updatedSelectedModel(): void
+    {
+        $this->useCustomModel = ($this->selectedModel === 'custom');
+    }
+
+    #[Computed]
+    public function availableProviders(): array
+    {
+        return $this->providerService()->getProviderOptions();
+    }
+
+    #[Computed]
+    public function modelsForSelectedProvider(): array
+    {
+        $provider = AiProvider::tryFrom($this->selectedProvider);
+
+        if (! $provider) {
+            return [];
+        }
+
+        return $this->providerService()->getModelsForProvider($provider);
+    }
+
+    #[Computed]
+    public function hasProviders(): bool
+    {
+        return $this->providerService()->hasAvailableProviders();
+    }
+
+    protected function initializeProviderDefaults(): void
+    {
+        $service = $this->providerService();
+        $defaultProvider = $service->getDefaultProvider();
+
+        if ($defaultProvider) {
+            $this->selectedProvider = $defaultProvider->value;
+            $this->selectedModel = $service->getDefaultModel($defaultProvider) ?? '';
+        }
+    }
+
+    protected function initializeFromProject(string $currentProvider, ?string $currentModel): void
+    {
+        $service = $this->providerService();
+
+        // Set current provider or fall back to default
+        $this->selectedProvider = $currentProvider ?: ($service->getDefaultProvider()?->value ?? '');
+
+        // Check if current model is in curated list
+        $provider = AiProvider::tryFrom($this->selectedProvider);
+
+        if (! $provider) {
+            return;
+        }
+
+        $curatedModels = $service->getModelsForProvider($provider);
+
+        if ($currentModel && ! isset($curatedModels[$currentModel])) {
+            // Current model is custom
+            $this->useCustomModel = true;
+            $this->customModel = $currentModel;
+            $this->selectedModel = 'custom';
+        } else {
+            $this->selectedModel = $currentModel ?: ($service->getDefaultModel($provider) ?? '');
+            $this->useCustomModel = false;
+            $this->customModel = '';
+        }
+    }
+
+    protected function getProviderValidationRules(): array
+    {
+        $rules = [
+            'selectedProvider' => 'required',
+            'selectedModel' => 'required',
+        ];
+
+        if ($this->useCustomModel) {
+            $rules['customModel'] = 'required|string|min:3|max:100';
+        }
+
+        return $rules;
+    }
+
+    protected function getFinalModel(): string
+    {
+        return $this->useCustomModel ? $this->customModel : $this->selectedModel;
+    }
+
+    protected function providerService(): ProviderService
+    {
+        return app(ProviderService::class);
+    }
+}

app/Livewire/Projects/Index.php

@@ -3,42 +3,58 @@
 namespace App\Livewire\Projects;
 
 use App\Enums\ProjectStatus;
+use App\Livewire\Concerns\ManagesProviderSelection;
 use App\Models\Project;
 use Livewire\Attributes\Layout;
 use Livewire\Component;
 
 #[Layout('components.layouts.app')]
 class Index extends Component
 {
+    use ManagesProviderSelection;
+
     public string $name = '';
 
     public string $idea = '';
 
     public bool $showCreateModal = false;
 
+    public function mount(): void
+    {
+        $this->initializeProviderDefaults();
+    }
+
     public function openCreateModal(): void
     {
+        $this->initializeProviderDefaults();
         $this->showCreateModal = true;
     }
 
     public function closeCreateModal(): void
     {
         $this->showCreateModal = false;
-        $this->reset(['name', 'idea']);
+        $this->reset(['name', 'idea', 'selectedProvider', 'selectedModel', 'useCustomModel', 'customModel']);
     }
 
     public function createProject(): void
     {
-        $this->validate([
-            'name' => 'required|min:3|max:255',
-            'idea' => 'required|min:10',
-        ]);
+        $rules = array_merge(
+            [
+                'name' => 'required|min:3|max:255',
+                'idea' => 'required|min:10',
+            ],
+            $this->getProviderValidationRules()
+        );
+
+        $this->validate($rules);
 
         // For now, use user_id = 1 (test user) since we don't have auth yet
         $project = Project::create([
             'user_id' => 1,
             'name' => $this->name,
             'idea' => $this->idea,
+            'preferred_provider' => $this->selectedProvider,
+            'preferred_model' => $this->getFinalModel(),
             'status' => ProjectStatus::Active,
         ]);