Add AI provider abstraction and asset storage (tasks #33, #34)

AiProviderDriver: one generic interface (generate(prompt, options) -> AiGenerationResult) rather than per-capability interfaces, since text (OpenAI chat completions), image (StabilityAI stable-image), and speech (ElevenLabs TTS) generation all reduce to prompt-in/content-out. Drivers throw AiGenerationException on failure; AiProviderManager resolves the right driver from an AiProvider record's `provider` column and guards on is_active. Real request/response shapes per each provider's API, verified with Http::fake() — no live API keys available yet to smoke test against the real services. AssetStorage: stores generated content under video-projects/{id}/{type}/v{n}.{ext}, versioned per (project, type[, step]) slot so retries don't clobber earlier output, plus contents/url/delete and pruneOldVersions for cleanup. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-06 20:47:06 +03:00
parent a4ff6c0ccb
commit 0e315ada04
14 changed files with 657 additions and 0 deletions
@@ -0,0 +1,46 @@
+<?php
+
+use App\Models\AiProvider;
+use App\Support\AiProviders\AiGenerationException;
+use App\Support\AiProviders\AiGenerationResult;
+use App\Support\AiProviders\AiProviderDriver;
+use App\Support\AiProviders\AiProviderManager;
+
+test('it dispatches to the driver registered for the provider key', function () {
+    $driver = new class implements AiProviderDriver
+    {
+        public function generate(AiProvider $provider, string $prompt, array $options = []): AiGenerationResult
+        {
+            return new AiGenerationResult("echo: {$prompt}", 'text/plain');
+        }
+    };
+
+    $manager = new AiProviderManager(['openai' => $driver]);
+    $provider = AiProvider::factory()->create(['provider' => 'openai']);
+
+    $result = $manager->generate($provider, 'hello');
+
+    expect($result->content)->toBe('echo: hello');
+});
+
+test('it throws when no driver is registered for the provider key', function () {
+    $manager = new AiProviderManager([]);
+    $provider = AiProvider::factory()->create(['provider' => 'openai']);
+
+    $manager->generate($provider, 'hello');
+})->throws(AiGenerationException::class, "No driver registered for AI provider 'openai'");
+
+test('it refuses to generate with an inactive provider', function () {
+    $driver = new class implements AiProviderDriver
+    {
+        public function generate(AiProvider $provider, string $prompt, array $options = []): AiGenerationResult
+        {
+            throw new RuntimeException('should not be called');
+        }
+    };
+
+    $manager = new AiProviderManager(['openai' => $driver]);
+    $provider = AiProvider::factory()->create(['provider' => 'openai', 'is_active' => false]);
+
+    $manager->generate($provider, 'hello');
+})->throws(AiGenerationException::class, 'is not active');