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>

tests/Feature/AiProviders/AiProviderManagerTest.php

@@ -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');

tests/Feature/AiProviders/ElevenLabsDriverTest.php

@@ -0,0 +1,55 @@
+<?php
+
+use App\Models\AiProvider;
+use App\Support\AiProviders\AiGenerationException;
+use App\Support\AiProviders\ElevenLabsDriver;
+use Illuminate\Support\Facades\Http;
+
+test('it generates audio successfully', function () {
+    Http::fake([
+        'api.elevenlabs.io/*' => Http::response('fake-mp3-bytes', 200, ['Content-Type' => 'audio/mpeg']),
+    ]);
+
+    $provider = AiProvider::factory()->create([
+        'provider' => 'elevenlabs',
+        'api_key' => 'el-test',
+        'config' => ['voice_id' => 'voice123'],
+    ]);
+
+    $result = (new ElevenLabsDriver)->generate($provider, 'Hello world');
+
+    expect($result->content)->toBe('fake-mp3-bytes');
+    expect($result->contentType)->toBe('audio/mpeg');
+
+    Http::assertSent(function ($request) {
+        return $request->url() === 'https://api.elevenlabs.io/v1/text-to-speech/voice123'
+            && $request->hasHeader('xi-api-key', 'el-test')
+            && $request['text'] === 'Hello world';
+    });
+});
+
+test('a voice_id passed in options overrides the provider config', function () {
+    Http::fake(['api.elevenlabs.io/*' => Http::response('bytes')]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'elevenlabs', 'config' => ['voice_id' => 'default-voice']]);
+
+    (new ElevenLabsDriver)->generate($provider, 'hi', ['voice_id' => 'custom-voice']);
+
+    Http::assertSent(fn ($request) => str_contains($request->url(), '/text-to-speech/custom-voice'));
+});
+
+test('it throws when no voice_id is configured anywhere', function () {
+    $provider = AiProvider::factory()->create(['provider' => 'elevenlabs', 'config' => null]);
+
+    (new ElevenLabsDriver)->generate($provider, 'hi');
+})->throws(AiGenerationException::class, 'no voice_id configured');
+
+test('it throws when ElevenLabs returns an error', function () {
+    Http::fake([
+        'api.elevenlabs.io/*' => Http::response(['detail' => ['message' => 'quota exceeded']], 429),
+    ]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'elevenlabs', 'config' => ['voice_id' => 'v1']]);
+
+    (new ElevenLabsDriver)->generate($provider, 'hi');
+})->throws(AiGenerationException::class, 'quota exceeded');

tests/Feature/AiProviders/OpenAiDriverTest.php

@@ -0,0 +1,62 @@
+<?php
+
+use App\Models\AiProvider;
+use App\Support\AiProviders\AiGenerationException;
+use App\Support\AiProviders\OpenAiDriver;
+use Illuminate\Support\Facades\Http;
+
+test('it generates text successfully', function () {
+    Http::fake([
+        'api.openai.com/*' => Http::response([
+            'choices' => [
+                ['message' => ['content' => 'Once upon a time...']],
+            ],
+        ], 200),
+    ]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'openai', 'api_key' => 'sk-test']);
+
+    $result = (new OpenAiDriver)->generate($provider, 'Write a story opener');
+
+    expect($result->content)->toBe('Once upon a time...');
+    expect($result->contentType)->toBe('text/plain');
+
+    Http::assertSent(function ($request) {
+        return $request->url() === 'https://api.openai.com/v1/chat/completions'
+            && $request->hasHeader('Authorization', 'Bearer sk-test')
+            && $request['messages'][0]['content'] === 'Write a story opener'
+            && $request['model'] === 'gpt-4o-mini';
+    });
+});
+
+test('it uses a model from options over the provider config over the default', function () {
+    Http::fake([
+        'api.openai.com/*' => Http::response(['choices' => [['message' => ['content' => 'hi']]]]),
+    ]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'openai', 'config' => ['model' => 'gpt-4o']]);
+
+    (new OpenAiDriver)->generate($provider, 'hi', ['model' => 'gpt-4-turbo']);
+
+    Http::assertSent(fn ($request) => $request['model'] === 'gpt-4-turbo');
+});
+
+test('it throws when OpenAI returns an error', function () {
+    Http::fake([
+        'api.openai.com/*' => Http::response(['error' => ['message' => 'Invalid API key']], 401),
+    ]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'openai']);
+
+    (new OpenAiDriver)->generate($provider, 'hi');
+})->throws(AiGenerationException::class, 'Invalid API key');
+
+test('it throws when the response has no message content', function () {
+    Http::fake([
+        'api.openai.com/*' => Http::response(['choices' => []]),
+    ]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'openai']);
+
+    (new OpenAiDriver)->generate($provider, 'hi');
+})->throws(AiGenerationException::class);

tests/Feature/AiProviders/StabilityAiDriverTest.php

@@ -0,0 +1,63 @@
+<?php
+
+use App\Models\AiProvider;
+use App\Support\AiProviders\AiGenerationException;
+use App\Support\AiProviders\StabilityAiDriver;
+use Illuminate\Support\Facades\Http;
+
+test('it generates an image successfully', function () {
+    $bytes = 'fake-png-bytes';
+
+    Http::fake([
+        'api.stability.ai/*' => Http::response([
+            'image' => base64_encode($bytes),
+            'seed' => 42,
+            'finish_reason' => 'SUCCESS',
+        ], 200),
+    ]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'stability_ai', 'api_key' => 'sk-test']);
+
+    $result = (new StabilityAiDriver)->generate($provider, 'a red bicycle');
+
+    expect($result->content)->toBe($bytes);
+    expect($result->contentType)->toBe('image/png');
+    expect($result->raw['seed'])->toBe(42);
+
+    Http::assertSent(function ($request) {
+        return $request->url() === 'https://api.stability.ai/v2beta/stable-image/generate/core'
+            && $request->hasHeader('Authorization', 'Bearer sk-test');
+    });
+});
+
+test('it respects an output_format override', function () {
+    Http::fake([
+        'api.stability.ai/*' => Http::response(['image' => base64_encode('bytes')]),
+    ]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'stability_ai']);
+
+    $result = (new StabilityAiDriver)->generate($provider, 'prompt', ['output_format' => 'webp']);
+
+    expect($result->contentType)->toBe('image/webp');
+});
+
+test('it throws when StabilityAI returns an error', function () {
+    Http::fake([
+        'api.stability.ai/*' => Http::response(['errors' => ['invalid prompt']], 400),
+    ]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'stability_ai']);
+
+    (new StabilityAiDriver)->generate($provider, 'prompt');
+})->throws(AiGenerationException::class, 'invalid prompt');
+
+test('it throws when the response has no image data', function () {
+    Http::fake([
+        'api.stability.ai/*' => Http::response(['finish_reason' => 'CONTENT_FILTERED']),
+    ]);
+
+    $provider = AiProvider::factory()->create(['provider' => 'stability_ai']);
+
+    (new StabilityAiDriver)->generate($provider, 'prompt');
+})->throws(AiGenerationException::class);

tests/Feature/AssetStorage/AssetStorageTest.php

@@ -0,0 +1,113 @@
+<?php
+
+use App\Models\VideoProject;
+use App\Models\WorkflowStep;
+use App\Support\AssetStorage\AssetStorage;
+use Illuminate\Support\Facades\Storage;
+
+beforeEach(function () {
+    Storage::fake();
+    $this->storage = new AssetStorage;
+});
+
+test('storing content writes the file and creates an asset record', function () {
+    $project = VideoProject::factory()->create();
+
+    $asset = $this->storage->store($project, 'script', 'Once upon a time...', 'txt', mimeType: 'text/plain');
+
+    expect($asset->type)->toBe('script');
+    expect($asset->version)->toBe(1);
+    expect($asset->size_bytes)->toBe(strlen('Once upon a time...'));
+    expect($asset->mime_type)->toBe('text/plain');
+    expect($asset->video_project_id)->toBe($project->id);
+
+    Storage::assertExists($asset->disk_path);
+    expect(Storage::get($asset->disk_path))->toBe('Once upon a time...');
+});
+
+test('storing the same slot again increments the version instead of overwriting', function () {
+    $project = VideoProject::factory()->create();
+
+    $v1 = $this->storage->store($project, 'script', 'draft one', 'txt');
+    $v2 = $this->storage->store($project, 'script', 'draft two', 'txt');
+
+    expect($v1->version)->toBe(1);
+    expect($v2->version)->toBe(2);
+    expect($v1->disk_path)->not->toBe($v2->disk_path);
+
+    Storage::assertExists($v1->disk_path);
+    Storage::assertExists($v2->disk_path);
+    expect(Storage::get($v1->disk_path))->toBe('draft one');
+    expect(Storage::get($v2->disk_path))->toBe('draft two');
+});
+
+test('versioning is scoped per workflow step when one is given', function () {
+    $project = VideoProject::factory()->create();
+    $stepA = WorkflowStep::factory()->for($project)->create(['order' => 0]);
+    $stepB = WorkflowStep::factory()->for($project)->create(['order' => 1]);
+
+    $a = $this->storage->store($project, 'script', 'from step A', 'txt', step: $stepA);
+    $b = $this->storage->store($project, 'script', 'from step B', 'txt', step: $stepB);
+
+    expect($a->version)->toBe(1);
+    expect($b->version)->toBe(1);
+});
+
+test('contents retrieves the stored file', function () {
+    $project = VideoProject::factory()->create();
+    $asset = $this->storage->store($project, 'script', 'hello', 'txt');
+
+    expect($this->storage->contents($asset))->toBe('hello');
+});
+
+test('url returns null for a missing file and a path for an existing one', function () {
+    $project = VideoProject::factory()->create();
+    $asset = $this->storage->store($project, 'script', 'hello', 'txt');
+
+    expect($this->storage->url($asset))->not->toBeNull();
+
+    Storage::delete($asset->disk_path);
+
+    expect($this->storage->url($asset))->toBeNull();
+});
+
+test('delete removes the file and the asset record', function () {
+    $project = VideoProject::factory()->create();
+    $asset = $this->storage->store($project, 'script', 'hello', 'txt');
+
+    $this->storage->delete($asset);
+
+    Storage::assertMissing($asset->disk_path);
+    expect(\App\Models\Asset::find($asset->id))->toBeNull();
+});
+
+test('pruneOldVersions keeps only the newest N versions', function () {
+    $project = VideoProject::factory()->create();
+
+    $versions = collect(range(1, 5))->map(
+        fn ($i) => $this->storage->store($project, 'script', "draft {$i}", 'txt')
+    );
+
+    $pruned = $this->storage->pruneOldVersions($project, 'script', keep: 2);
+
+    expect($pruned)->toBe(3);
+
+    $remaining = $project->assets()->where('type', 'script')->pluck('version')->sort()->values();
+    expect($remaining->all())->toBe([4, 5]);
+
+    Storage::assertMissing($versions[0]->disk_path);
+    Storage::assertMissing($versions[1]->disk_path);
+    Storage::assertMissing($versions[2]->disk_path);
+    Storage::assertExists($versions[3]->disk_path);
+    Storage::assertExists($versions[4]->disk_path);
+});
+
+test('pruneOldVersions does nothing when there are fewer versions than the keep count', function () {
+    $project = VideoProject::factory()->create();
+    $this->storage->store($project, 'script', 'only draft', 'txt');
+
+    $pruned = $this->storage->pruneOldVersions($project, 'script', keep: 3);
+
+    expect($pruned)->toBe(0);
+    expect($project->assets()->count())->toBe(1);
+});