Initial commit: Runware-powered content generator foundation

Laravel app with a cost-tracked Runware.ai integration (image, video,
text generation), a hard monthly EUR budget cap with live USD/EUR FX
conversion, and a locally-maintained model/pricing table since
Runware's model-search API doesn't expose pricing.

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[{compose,docker-compose}.{yml,yaml}]
+indent_size = 4

.env.example

@@ -0,0 +1,75 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_URL=http://localhost:8000
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+# APP_MAINTENANCE_STORE=database
+
+# PHP_CLI_SERVER_WORKERS=4
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=dreamstudio
+DB_USERNAME=root
+DB_PASSWORD=
+
+RUNWARE_API_KEY=
+RUNWARE_BASE_URL=https://api.runware.ai/v1
+RUNWARE_MONTHLY_CAP_EUR=20
+RUNWARE_USD_EUR_FALLBACK_RATE=0.92
+RUNWARE_SAFETY_MARGIN=0.10
+RUNWARE_WARN_THRESHOLD=0.80
+RUNWARE_IMAGE_MODEL=
+RUNWARE_VIDEO_MODEL=
+RUNWARE_TEXT_MODEL=
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+# CACHE_PREFIX=
+
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_MAILER=log
+MAIL_SCHEME=null
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_FROM_ADDRESS="hello@example.com"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"

.gitattributes

@@ -0,0 +1,11 @@
+* text=auto eol=lf
+
+*.blade.php diff=html
+*.css diff=css
+*.html diff=html
+*.md diff=markdown
+*.php diff=php
+
+/.github export-ignore
+CHANGELOG.md export-ignore
+.styleci.yml export-ignore

.gitignore

@@ -0,0 +1,27 @@
+*.log
+.DS_Store
+.env
+.env.backup
+.env.production
+.phpactor.json
+.phpunit.result.cache
+/.codex
+/.cursor/
+/.idea
+/.nova
+/.phpunit.cache
+/.vscode
+/.zed
+/auth.json
+/node_modules
+/public/build
+/public/fonts-manifest.dev.json
+/public/hot
+/public/storage
+/storage/*.key
+/storage/pail
+/vendor
+_ide_helper.php
+Homestead.json
+Homestead.yaml
+Thumbs.db

.npmrc

@@ -0,0 +1,2 @@
+ignore-scripts=true
+audit=true

AGENTS.md

@@ -0,0 +1,47 @@
+<laravel-boost-guidelines>
+# Laravel Application
+
+This repository contains a Laravel application. Complete the following setup before working on the user's request.
+
+## Prerequisites
+
+Verify that PHP and Composer are available:
+
+```sh
+php -v
+composer -V
+```
+
+If either command is unavailable, detect the user's operating system and install the prerequisites with the appropriate command:
+
+macOS:
+
+```sh
+/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.5)"
+```
+
+Windows PowerShell:
+
+```powershell
+Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.5'))
+```
+
+Linux:
+
+```sh
+/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.5)"
+```
+
+After installation, ask the user to restart their terminal. If the agent needs the restarted shell to continue, ask the user to reopen their terminal and rerun their original prompt.
+
+## Agent Setup
+
+Install Laravel Boost from the application root before making application changes:
+
+```sh
+composer require laravel/boost --dev
+php artisan boost:install
+```
+
+Boost replaces these bootstrap instructions with guidelines tailored to the application. After installation, read `AGENTS.md` again and continue with the user's original request using the generated guidelines.
+</laravel-boost-guidelines>

CLAUDE.md

@@ -0,0 +1,47 @@
+<laravel-boost-guidelines>
+# Laravel Application
+
+This repository contains a Laravel application. Complete the following setup before working on the user's request.
+
+## Prerequisites
+
+Verify that PHP and Composer are available:
+
+```sh
+php -v
+composer -V
+```
+
+If either command is unavailable, detect the user's operating system and install the prerequisites with the appropriate command:
+
+macOS:
+
+```sh
+/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.5)"
+```
+
+Windows PowerShell:
+
+```powershell
+Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.5'))
+```
+
+Linux:
+
+```sh
+/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.5)"
+```
+
+After installation, ask the user to restart their terminal. If the agent needs the restarted shell to continue, ask the user to reopen their terminal and rerun their original prompt.
+
+## Agent Setup
+
+Install Laravel Boost from the application root before making application changes:
+
+```sh
+composer require laravel/boost --dev
+php artisan boost:install
+```
+
+Boost replaces these bootstrap instructions with guidelines tailored to the application. After installation, read `AGENTS.md` again and continue with the user's original request using the generated guidelines.
+</laravel-boost-guidelines>

README.md

@@ -0,0 +1,58 @@
+<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p>
+
+<p align="center">
+<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a>
+</p>
+
+## About Laravel
+
+Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:
+
+- [Simple, fast routing engine](https://laravel.com/docs/routing).
+- [Powerful dependency injection container](https://laravel.com/docs/container).
+- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage.
+- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent).
+- Database agnostic [schema migrations](https://laravel.com/docs/migrations).
+- [Robust background job processing](https://laravel.com/docs/queues).
+- [Real-time event broadcasting](https://laravel.com/docs/broadcasting).
+
+Laravel is accessible, powerful, and provides tools required for large, robust applications.
+
+## Learning Laravel
+
+Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.
+
+In addition, [Laracasts](https://laracasts.com) contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.
+
+You can also watch bite-sized lessons with real-world projects on [Laravel Learn](https://laravel.com/learn), where you will be guided through building a Laravel application from scratch while learning PHP fundamentals.
+
+## Agentic Development
+
+Laravel's predictable structure and conventions make it ideal for AI coding agents like Claude Code, Cursor, and GitHub Copilot. Install [Laravel Boost](https://laravel.com/docs/ai) to supercharge your AI workflow:
+
+```bash
+composer require laravel/boost --dev
+
+php artisan boost:install
+```
+
+Boost provides your agent 15+ tools and skills that help agents build Laravel applications while following best practices.
+
+## Contributing
+
+Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).
+
+## Code of Conduct
+
+In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).
+
+## Security Vulnerabilities
+
+If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed.
+
+## License
+
+The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

app/Exceptions/BudgetExceededException.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Exceptions;
+
+use RuntimeException;
+
+class BudgetExceededException extends RuntimeException
+{
+    public function __construct(
+        public readonly float $spentEur,
+        public readonly float $capEur,
+        public readonly float $estimatedEur,
+    ) {
+        parent::__construct(sprintf(
+            'Runware monthly budget would be exceeded: %.2f€ spent + %.2f€ estimated > %.2f€ cap.',
+            $spentEur,
+            $estimatedEur,
+            $capEur,
+        ));
+    }
+}

app/Http/Controllers/Controller.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace App\Http\Controllers;
+
+abstract class Controller
+{
+    //
+}

app/Http/Controllers/GenerationController.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Exceptions\BudgetExceededException;
+use App\Models\Generation;
+use App\Models\RunwareModel;
+use App\Services\Runware\BudgetGuard;
+use App\Services\Runware\GenerationService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class GenerationController extends Controller
+{
+    public function index(BudgetGuard $budget): View
+    {
+        return view('generations.index', [
+            'generations' => Generation::query()->latest()->paginate(20),
+            'models' => RunwareModel::query()->where('active', true)->orderBy('modality')->orderBy('price_usd')->get()->groupBy('modality'),
+            'capEur' => $budget->capEur(),
+            'spentEur' => $budget->spentEurThisMonth(),
+            'remainingEur' => $budget->remainingEur(),
+            'warnThresholdReached' => $budget->warnThresholdReached(),
+        ]);
+    }
+
+    public function store(Request $request, GenerationService $generations): RedirectResponse
+    {
+        $data = $request->validate([
+            'type' => ['required', 'in:image,video,text'],
+            'prompt' => ['required', 'string', 'max:4000'],
+            'model' => ['nullable', 'string'],
+            'width' => ['nullable', 'integer', 'min:64', 'max:2048'],
+            'height' => ['nullable', 'integer', 'min:64', 'max:2048'],
+            'duration' => ['nullable', 'integer', 'min:1', 'max:30'],
+        ]);
+
+        $params = array_filter([
+            'width' => $data['width'] ?? null,
+            'height' => $data['height'] ?? null,
+            'duration' => $data['duration'] ?? null,
+        ], fn ($v) => $v !== null);
+
+        try {
+            match ($data['type']) {
+                'image' => $generations->createImage($data['prompt'], $params, $data['model'] ?? null),
+                'text' => $generations->createText($data['prompt'], $params, $data['model'] ?? null),
+                'video' => $generations->queueVideo($data['prompt'], $params, $data['model'] ?? null),
+            };
+        } catch (BudgetExceededException $e) {
+            return back()->withErrors(['budget' => $e->getMessage()])->withInput();
+        } catch (\Throwable $e) {
+            return back()->withErrors(['generation' => 'Generation failed: '.$e->getMessage()])->withInput();
+        }
+
+        return redirect()->route('generations.index');
+    }
+}

app/Http/Controllers/RunwareModelController.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\RunwareModel;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class RunwareModelController extends Controller
+{
+    public function index(): View
+    {
+        return view('runware-models.index', [
+            'models' => RunwareModel::query()->orderBy('modality')->orderBy('price_usd')->get(),
+        ]);
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        $data = $request->validate([
+            'modality' => ['required', 'in:image,video,text'],
+            'air_id' => ['required', 'string', 'max:255'],
+            'label' => ['required', 'string', 'max:255'],
+            'unit' => ['required', 'in:per_image,per_second,per_million_tokens'],
+            'price_usd' => ['required', 'numeric', 'min:0'],
+        ]);
+
+        RunwareModel::create($data);
+        RunwareModel::recomputeDefault($data['modality']);
+
+        return redirect()->route('runware-models.index');
+    }
+
+    public function update(Request $request, RunwareModel $runwareModel): RedirectResponse
+    {
+        $data = $request->validate([
+            'active' => ['required', 'boolean'],
+        ]);
+
+        $runwareModel->update($data);
+        RunwareModel::recomputeDefault($runwareModel->modality);
+
+        return redirect()->route('runware-models.index');
+    }
+
+    public function destroy(RunwareModel $runwareModel): RedirectResponse
+    {
+        $modality = $runwareModel->modality;
+        $runwareModel->delete();
+        RunwareModel::recomputeDefault($modality);
+
+        return redirect()->route('runware-models.index');
+    }
+}

app/Jobs/GenerateVideoJob.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Jobs;
+
+use App\Models\Generation;
+use App\Services\Runware\GenerationService;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use Throwable;
+
+class GenerateVideoJob implements ShouldQueue
+{
+    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
+
+    // Video submission + polling can legitimately take minutes.
+    public int $timeout = 900;
+
+    public int $tries = 1;
+
+    public function __construct(public Generation $generation) {}
+
+    public function handle(GenerationService $generations): void
+    {
+        try {
+            $generations->processVideo($this->generation);
+        } catch (Throwable $e) {
+            $this->generation->update(['status' => 'failed', 'error' => $e->getMessage()]);
+            throw $e;
+        }
+    }
+}

app/Models/Generation.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class Generation extends Model
+{
+    protected $fillable = [
+        'batch_id',
+        'type',
+        'model',
+        'prompt',
+        'params',
+        'status',
+        'runware_task_uuid',
+        'cost_usd',
+        'cost_eur',
+        'cost_is_estimated',
+        'output_path',
+        'output_text',
+        'error',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'params' => 'array',
+            'cost_usd' => 'decimal:6',
+            'cost_eur' => 'decimal:6',
+            'cost_is_estimated' => 'boolean',
+        ];
+    }
+}

app/Models/RunwareModel.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class RunwareModel extends Model
+{
+    protected $fillable = [
+        'modality',
+        'air_id',
+        'label',
+        'unit',
+        'price_usd',
+        'is_default',
+        'active',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'price_usd' => 'decimal:6',
+            'is_default' => 'boolean',
+            'active' => 'boolean',
+        ];
+    }
+
+    public static function defaultFor(string $modality): ?self
+    {
+        return static::query()
+            ->where('modality', $modality)
+            ->where('is_default', true)
+            ->where('active', true)
+            ->first();
+    }
+
+    /**
+     * The cheapest active model always wins the default flag, since Runware's
+     * own model-search API doesn't expose pricing — this locally-entered
+     * table is the only place "cheapest" can be computed from.
+     */
+    public static function recomputeDefault(string $modality): void
+    {
+        static::query()->where('modality', $modality)->update(['is_default' => false]);
+
+        $cheapest = static::query()
+            ->where('modality', $modality)
+            ->where('active', true)
+            ->orderBy('price_usd')
+            ->orderBy('id')
+            ->first();
+
+        $cheapest?->update(['is_default' => true]);
+    }
+}

app/Models/User.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Models;
+
+// use Illuminate\Contracts\Auth\MustVerifyEmail;
+use Database\Factories\UserFactory;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Attributes\Hidden;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Foundation\Auth\User as Authenticatable;
+use Illuminate\Notifications\Notifiable;
+
+#[Fillable(['name', 'email', 'password'])]
+#[Hidden(['password', 'remember_token'])]
+class User extends Authenticatable
+{
+    /** @use HasFactory<UserFactory> */
+    use HasFactory, Notifiable;
+
+    /**
+     * Get the attributes that should be cast.
+     *
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'email_verified_at' => 'datetime',
+            'password' => 'hashed',
+        ];
+    }
+}

app/Providers/AppServiceProvider.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Providers;
+
+use App\Services\Runware\RunwareClient;
+use Illuminate\Support\ServiceProvider;
+
+class AppServiceProvider extends ServiceProvider
+{
+    /**
+     * Register any application services.
+     */
+    public function register(): void
+    {
+        $this->app->singleton(RunwareClient::class, fn () => new RunwareClient(
+            apiKey: (string) config('runware.api_key'),
+            baseUrl: (string) config('runware.base_url'),
+        ));
+    }
+
+    /**
+     * Bootstrap any application services.
+     */
+    public function boot(): void
+    {
+        //
+    }
+}

app/Services/Runware/BudgetGuard.php

@@ -0,0 +1,73 @@
+<?php
+
+namespace App\Services\Runware;
+
+use App\Exceptions\BudgetExceededException;
+use App\Models\Generation;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\DB;
+
+/**
+ * Enforces the hard monthly EUR spend cap on Runware usage. Every generation
+ * must go through ensureCanSpend() before the API is called, and the actual
+ * cost must be reconciled afterward via recordActualUsd() so the running
+ * total reflects reality (Runware only bills successful generations).
+ */
+class BudgetGuard
+{
+    protected const LOCK_KEY = 'runware:budget-guard-lock';
+
+    protected const LOCK_TIMEOUT_SECONDS = 10;
+
+    public function __construct(protected CurrencyRateService $rates) {}
+
+    public function capEur(): float
+    {
+        return (float) config('runware.monthly_cap_eur');
+    }
+
+    public function spentEurThisMonth(): float
+    {
+        return (float) Generation::query()
+            ->where('created_at', '>=', now()->startOfMonth())
+            ->whereNotNull('cost_eur')
+            ->sum('cost_eur');
+    }
+
+    public function remainingEur(): float
+    {
+        return max(0.0, $this->capEur() - $this->spentEurThisMonth());
+    }
+
+    public function warnThresholdReached(): bool
+    {
+        $cap = $this->capEur();
+
+        if ($cap <= 0) {
+            return false;
+        }
+
+        return ($this->spentEurThisMonth() / $cap) >= (float) config('runware.warn_threshold');
+    }
+
+    /**
+     * Throws BudgetExceededException if spending $estimatedUsd would push
+     * this month's total (plus a safety margin) past the cap. Guards the
+     * check with an atomic lock so concurrent requests can't both slip
+     * through right at the boundary.
+     */
+    public function ensureCanSpend(float $estimatedUsd): void
+    {
+        Cache::lock(self::LOCK_KEY, self::LOCK_TIMEOUT_SECONDS)->block(5, function () use ($estimatedUsd) {
+            $rate = $this->rates->usdToEur();
+            $estimatedEur = $estimatedUsd * $rate;
+            $spent = $this->spentEurThisMonth();
+            $cap = $this->capEur();
+            $margin = $cap * (float) config('runware.safety_margin');
+
+            if ($spent + $estimatedEur + $margin > $cap) {
+                throw new BudgetExceededException($spent, $cap, $estimatedEur);
+            }
+        });
+    }
+}

app/Services/Runware/CostEstimator.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Services\Runware;
+
+use App\Models\RunwareModel;
+
+/**
+ * Pre-flight cost estimation used by BudgetGuard before a Runware call is
+ * made. Deliberately conservative — the real cost is always reconciled
+ * afterward from Runware's response `cost` field (or, for text, `usage.cost`).
+ */
+class CostEstimator
+{
+    protected const DEFAULT_VIDEO_DURATION_SECONDS = 5;
+
+    protected const DEFAULT_TEXT_TOKEN_BUDGET = 2048;
+
+    public function estimateUsd(RunwareModel $model, array $params): float
+    {
+        return match ($model->unit) {
+            'per_image' => (float) $model->price_usd * (int) ($params['numberResults'] ?? 1),
+            'per_second' => (float) $model->price_usd * (int) ($params['duration'] ?? self::DEFAULT_VIDEO_DURATION_SECONDS),
+            'per_million_tokens' => (float) $model->price_usd
+                * (((int) ($params['max_completion_tokens'] ?? self::DEFAULT_TEXT_TOKEN_BUDGET)) / 1_000_000),
+        };
+    }
+}

app/Services/Runware/CurrencyRateService.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Services\Runware;
+
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * Keeps a live-ish USD->EUR rate cached for BudgetGuard to convert Runware's
+ * USD costs against the EUR monthly cap. Refreshed daily by the scheduler
+ * (see routes/console.php); falls back to a static configured rate if no
+ * live fetch has ever succeeded, so the cap never stops enforcing.
+ */
+class CurrencyRateService
+{
+    protected const CACHE_KEY = 'runware:usd_eur_rate';
+
+    // Refresh runs daily; keep the cached value alive well past that so a
+    // single failed fetch doesn't drop back to the fallback rate.
+    protected const CACHE_TTL_SECONDS = 60 * 60 * 30;
+
+    public function usdToEur(): float
+    {
+        return Cache::get(self::CACHE_KEY) ?? (float) config('runware.usd_eur_fallback_rate');
+    }
+
+    public function refresh(): ?float
+    {
+        try {
+            $response = Http::timeout(10)->get('https://api.frankfurter.app/latest', [
+                'from' => 'USD',
+                'to' => 'EUR',
+            ]);
+
+            $rate = $response->json('rates.EUR');
+
+            if (! $response->successful() || ! is_numeric($rate)) {
+                throw new \RuntimeException('Unexpected FX response: '.$response->body());
+            }
+
+            Cache::put(self::CACHE_KEY, (float) $rate, self::CACHE_TTL_SECONDS);
+
+            return (float) $rate;
+        } catch (\Throwable $e) {
+            Log::warning('Failed to refresh USD/EUR rate, keeping previous cached/fallback value.', [
+                'exception' => $e->getMessage(),
+            ]);
+
+            return null;
+        }
+    }
+}

app/Services/Runware/GenerationService.php

@@ -0,0 +1,251 @@
+<?php
+
+namespace App\Services\Runware;
+
+use App\Models\Generation;
+use App\Models\RunwareModel;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+use RuntimeException;
+use Throwable;
+
+/**
+ * Orchestrates a single Runware generation end to end: resolve the model,
+ * pre-flight budget check, call the API, persist the result, reconcile the
+ * real cost. Image and text run synchronously; video is long-running and is
+ * driven by App\Jobs\GenerateVideoJob via queueVideo()/processVideo().
+ */
+class GenerationService
+{
+    public function __construct(
+        protected RunwareClient $client,
+        protected BudgetGuard $budget,
+        protected CostEstimator $estimator,
+        protected CurrencyRateService $rates,
+    ) {}
+
+    public function resolveModel(string $modality, ?string $airIdOverride = null): RunwareModel
+    {
+        if ($airIdOverride) {
+            $model = RunwareModel::query()
+                ->where('modality', $modality)
+                ->where('air_id', $airIdOverride)
+                ->where('active', true)
+                ->first();
+
+            if ($model) {
+                return $model;
+            }
+        }
+
+        return RunwareModel::defaultFor($modality)
+            ?? throw new RuntimeException("No default {$modality} model configured. Add one under Runware Models.");
+    }
+
+    public function createImage(string $prompt, array $params = [], ?string $modelOverride = null): Generation
+    {
+        $model = $this->resolveModel('image', $modelOverride);
+        $params = array_merge(['width' => 1024, 'height' => 1024, 'numberResults' => 1], $params);
+
+        $generation = Generation::create([
+            'type' => 'image',
+            'model' => $model->air_id,
+            'prompt' => $prompt,
+            'params' => $params,
+            'status' => 'pending',
+        ]);
+
+        $this->budget->ensureCanSpend($this->estimator->estimateUsd($model, $params));
+
+        try {
+            $taskUUID = (string) Str::uuid();
+
+            $results = $this->client->runTasks([array_merge([
+                'taskType' => 'imageInference',
+                'taskUUID' => $taskUUID,
+                'model' => $model->air_id,
+                'positivePrompt' => $prompt,
+                'includeCost' => true,
+            ], $params)]);
+
+            $result = $results[0];
+            $path = $this->downloadTo("generations/images/{$taskUUID}", $result['imageURL']);
+
+            $generation->update([
+                'status' => 'completed',
+                'runware_task_uuid' => $taskUUID,
+                'output_path' => $path,
+                ...$this->costFields($result['cost'] ?? null),
+            ]);
+        } catch (Throwable $e) {
+            $generation->update(['status' => 'failed', 'error' => $e->getMessage()]);
+            throw $e;
+        }
+
+        return $generation->fresh();
+    }
+
+    public function createText(string $prompt, array $params = [], ?string $modelOverride = null): Generation
+    {
+        $model = $this->resolveModel('text', $modelOverride);
+        $params = array_merge(['max_completion_tokens' => 1024], $params);
+
+        $generation = Generation::create([
+            'type' => 'text',
+            'model' => $model->air_id,
+            'prompt' => $prompt,
+            'params' => $params,
+            'status' => 'pending',
+        ]);
+
+        $this->budget->ensureCanSpend($this->estimator->estimateUsd($model, $params));
+
+        try {
+            $response = $this->client->chatCompletion([
+                'model' => $model->air_id,
+                'messages' => [['role' => 'user', 'content' => $prompt]],
+                ...$params,
+            ]);
+
+            $content = $response['choices'][0]['message']['content'] ?? throw new RuntimeException(
+                'Unexpected Runware chat response: '.json_encode($response)
+            );
+
+            $costUsd = $response['usage']['cost'] ?? null;
+            $estimated = false;
+
+            if ($costUsd === null) {
+                // Runware doesn't always return usage.cost for non-streaming
+                // chat completions; fall back to a token-based estimate and
+                // flag it so it's visible it isn't Runware's own figure.
+                $tokens = $response['usage']['total_tokens'] ?? $params['max_completion_tokens'];
+                $costUsd = (float) $model->price_usd * ($tokens / 1_000_000);
+                $estimated = true;
+            }
+
+            $generation->update([
+                'status' => 'completed',
+                'output_text' => $content,
+                ...$this->costFields($costUsd, $estimated),
+            ]);
+        } catch (Throwable $e) {
+            $generation->update(['status' => 'failed', 'error' => $e->getMessage()]);
+            throw $e;
+        }
+
+        return $generation->fresh();
+    }
+
+    public function queueVideo(string $prompt, array $params = [], ?string $modelOverride = null): Generation
+    {
+        $model = $this->resolveModel('video', $modelOverride);
+        $params = array_merge(['width' => 1280, 'height' => 720, 'duration' => 5], $params);
+
+        $this->budget->ensureCanSpend($this->estimator->estimateUsd($model, $params));
+
+        return Generation::create([
+            'type' => 'video',
+            'model' => $model->air_id,
+            'prompt' => $prompt,
+            'params' => $params,
+            'status' => 'pending',
+        ]);
+    }
+
+    /**
+     * Runs the actual video submit+poll+download flow. Called from
+     * App\Jobs\GenerateVideoJob, not directly from the controller, since
+     * video generation can take minutes.
+     */
+    public function processVideo(Generation $generation): void
+    {
+        $model = RunwareModel::query()
+            ->where('modality', 'video')
+            ->where('air_id', $generation->model)
+            ->firstOrFail();
+
+        // Re-check right before spending: time has passed since this job was
+        // queued and other generations may have consumed the budget since.
+        $this->budget->ensureCanSpend($this->estimator->estimateUsd($model, $generation->params ?? []));
+
+        $generation->update(['status' => 'processing']);
+
+        $taskUUID = (string) Str::uuid();
+
+        $this->client->runTasks([array_merge([
+            'taskType' => 'videoInference',
+            'taskUUID' => $taskUUID,
+            'model' => $model->air_id,
+            'positivePrompt' => $generation->prompt,
+            'deliveryMethod' => 'async',
+            'includeCost' => true,
+        ], $generation->params ?? [])]);
+
+        $result = $this->pollUntilDone($taskUUID);
+
+        $path = $this->downloadTo("generations/videos/{$taskUUID}", $result['videoURL']);
+
+        $generation->update([
+            'status' => 'completed',
+            'runware_task_uuid' => $taskUUID,
+            'output_path' => $path,
+            ...$this->costFields($result['cost'] ?? null),
+        ]);
+    }
+
+    protected function pollUntilDone(string $taskUUID): array
+    {
+        $delaySeconds = 2;
+        $elapsed = 0;
+        $maxSeconds = 600;
+
+        while ($elapsed < $maxSeconds) {
+            $result = $this->client->pollTask($taskUUID);
+            $status = $result['status'] ?? null;
+
+            if ($status === 'success') {
+                return $result;
+            }
+
+            if ($status === 'error') {
+                throw new RuntimeException('Runware video task failed: '.json_encode($result));
+            }
+
+            sleep($delaySeconds);
+            $elapsed += $delaySeconds;
+            $delaySeconds = min(10, $delaySeconds + 2);
+        }
+
+        throw new RuntimeException("Runware video task {$taskUUID} timed out after {$maxSeconds}s");
+    }
+
+    protected function downloadTo(string $relativePath, string $url): string
+    {
+        $response = Http::timeout(120)->get($url);
+
+        if ($response->failed()) {
+            throw new RuntimeException("Failed to download Runware output from {$url}");
+        }
+
+        $extension = pathinfo(parse_url($url, PHP_URL_PATH) ?? '', PATHINFO_EXTENSION) ?: 'bin';
+        $path = "{$relativePath}.{$extension}";
+
+        Storage::disk('public')->put($path, $response->body());
+
+        return $path;
+    }
+
+    protected function costFields(?float $costUsd, bool $estimated = false): array
+    {
+        if ($costUsd === null) {
+            return ['cost_usd' => null, 'cost_eur' => null, 'cost_is_estimated' => false];
+        }
+
+        return [
+            'cost_usd' => $costUsd,
+            'cost_eur' => $costUsd * $this->rates->usdToEur(),
+            'cost_is_estimated' => $estimated,
+        ];
+    }
+}

app/Services/Runware/RunwareClient.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace App\Services\Runware;
+
+use Illuminate\Support\Facades\Http;
+use RuntimeException;
+
+/**
+ * Thin wrapper around Runware's HTTP API. Image and video generation use the
+ * batched task-array endpoint (POST /v1, body is a JSON array of tasks);
+ * text/LLM generation uses Runware's separate OpenAI-compatible endpoint
+ * (POST /v1/chat/completions). See https://runware.ai/docs/platform/introduction
+ * and https://runware.ai/docs/platform/openai.
+ */
+class RunwareClient
+{
+    public function __construct(
+        protected string $apiKey,
+        protected string $baseUrl,
+    ) {}
+
+    /**
+     * @param  array<int, array<string, mixed>>  $tasks
+     * @return array<int, array<string, mixed>>
+     */
+    public function runTasks(array $tasks): array
+    {
+        $response = Http::withToken($this->apiKey)
+            ->timeout(120)
+            ->post($this->baseUrl, $tasks);
+
+        if ($response->failed()) {
+            throw new RuntimeException('Runware API request failed: '.$response->body());
+        }
+
+        $data = $response->json('data');
+
+        if (! is_array($data)) {
+            throw new RuntimeException('Unexpected Runware response shape: '.$response->body());
+        }
+
+        foreach ($data as $result) {
+            if (isset($result['error']) || ($result['status'] ?? null) === 'error') {
+                throw new RuntimeException('Runware task failed: '.json_encode($result));
+            }
+        }
+
+        return $data;
+    }
+
+    public function pollTask(string $taskUUID): array
+    {
+        $results = $this->runTasks([[
+            'taskType' => 'getResponse',
+            'taskUUID' => $taskUUID,
+        ]]);
+
+        return $results[0] ?? throw new RuntimeException("No poll result for task {$taskUUID}");
+    }
+
+    /**
+     * @param  array<string, mixed>  $payload
+     * @return array<string, mixed>
+     */
+    public function chatCompletion(array $payload): array
+    {
+        $response = Http::withToken($this->apiKey)
+            ->timeout(120)
+            ->post(rtrim($this->baseUrl, '/').'/chat/completions', $payload);
+
+        if ($response->failed()) {
+            throw new RuntimeException('Runware chat completion failed: '.$response->body());
+        }
+
+        return $response->json();
+    }
+}

artisan

@@ -0,0 +1,18 @@
+#!/usr/bin/env php
+<?php
+
+use Illuminate\Foundation\Application;
+use Symfony\Component\Console\Input\ArgvInput;
+
+define('LARAVEL_START', microtime(true));
+
+// Register the Composer autoloader...
+require __DIR__.'/vendor/autoload.php';
+
+// Bootstrap Laravel and handle the command...
+/** @var Application $app */
+$app = require_once __DIR__.'/bootstrap/app.php';
+
+$status = $app->handleCommand(new ArgvInput);
+
+exit($status);

bootstrap/app.php

@@ -0,0 +1,21 @@
+<?php
+
+use Illuminate\Foundation\Application;
+use Illuminate\Foundation\Configuration\Exceptions;
+use Illuminate\Foundation\Configuration\Middleware;
+use Illuminate\Http\Request;
+
+return Application::configure(basePath: dirname(__DIR__))
+    ->withRouting(
+        web: __DIR__.'/../routes/web.php',
+        commands: __DIR__.'/../routes/console.php',
+        health: '/up',
+    )
+    ->withMiddleware(function (Middleware $middleware): void {
+        //
+    })
+    ->withExceptions(function (Exceptions $exceptions): void {
+        $exceptions->shouldRenderJsonWhen(
+            fn (Request $request) => $request->is('api/*') || $request->expectsJson(),
+        );
+    })->create();

bootstrap/cache/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

bootstrap/providers.php

@@ -0,0 +1,7 @@
+<?php
+
+use App\Providers\AppServiceProvider;
+
+return [
+    AppServiceProvider::class,
+];

composer.json

@@ -0,0 +1,86 @@
+{
+    "$schema": "https://getcomposer.org/schema.json",
+    "name": "laravel/laravel",
+    "type": "project",
+    "description": "The skeleton application for the Laravel framework.",
+    "keywords": ["laravel", "framework"],
+    "license": "MIT",
+    "require": {
+        "php": "^8.3",
+        "laravel/framework": "^13.17",
+        "laravel/tinker": "^3.0"
+    },
+    "require-dev": {
+        "fakerphp/faker": "^1.23",
+        "laravel/pail": "^1.2.5",
+        "laravel/pao": "^1.0.6",
+        "laravel/pint": "^1.27",
+        "mockery/mockery": "^1.6",
+        "nunomaduro/collision": "^8.6",
+        "phpunit/phpunit": "^12.5.12"
+    },
+    "autoload": {
+        "psr-4": {
+            "App\\": "app/",
+            "Database\\Factories\\": "database/factories/",
+            "Database\\Seeders\\": "database/seeders/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests/"
+        }
+    },
+    "scripts": {
+        "setup": [
+            "composer install",
+            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\"",
+            "@php artisan key:generate",
+            "@php artisan migrate --force",
+            "npm install --ignore-scripts",
+            "npm run build"
+        ],
+        "dev": [
+            "Composer\\Config::disableProcessTimeout",
+            "@php artisan dev"
+        ],
+        "test": [
+            "@php artisan config:clear --ansi @no_additional_args",
+            "@php artisan test"
+        ],
+        "post-autoload-dump": [
+            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
+            "@php artisan package:discover --ansi"
+        ],
+        "post-update-cmd": [
+            "@php artisan vendor:publish --tag=laravel-assets --ansi --force"
+        ],
+        "post-root-package-install": [
+            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
+        ],
+        "post-create-project-cmd": [
+            "@php artisan key:generate --ansi",
+            "@php -r \"file_exists('database/database.sqlite') || touch('database/database.sqlite');\"",
+            "@php artisan migrate --graceful --ansi"
+        ],
+        "pre-package-uninstall": [
+            "Illuminate\\Foundation\\ComposerScripts::prePackageUninstall"
+        ]
+    },
+    "extra": {
+        "laravel": {
+            "dont-discover": []
+        }
+    },
+    "config": {
+        "optimize-autoloader": true,
+        "preferred-install": "dist",
+        "sort-packages": true,
+        "allow-plugins": {
+            "pestphp/pest-plugin": true,
+            "php-http/discovery": true
+        }
+    },
+    "minimum-stability": "stable",
+    "prefer-stable": true
+}

config/app.php

@@ -0,0 +1,126 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Name
+    |--------------------------------------------------------------------------
+    |
+    | This value is the name of your application, which will be used when the
+    | framework needs to place the application's name in a notification or
+    | other UI elements where an application name needs to be displayed.
+    |
+    */
+
+    'name' => env('APP_NAME', 'Laravel'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Environment
+    |--------------------------------------------------------------------------
+    |
+    | This value determines the "environment" your application is currently
+    | running in. This may determine how you prefer to configure various
+    | services the application utilizes. Set this in your ".env" file.
+    |
+    */
+
+    'env' => env('APP_ENV', 'production'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Debug Mode
+    |--------------------------------------------------------------------------
+    |
+    | When your application is in debug mode, detailed error messages with
+    | stack traces will be shown on every error that occurs within your
+    | application. If disabled, a simple generic error page is shown.
+    |
+    */
+
+    'debug' => (bool) env('APP_DEBUG', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application URL
+    |--------------------------------------------------------------------------
+    |
+    | This URL is used by the console to properly generate URLs when using
+    | the Artisan command line tool. You should set this to the root of
+    | the application so that it's available within Artisan commands.
+    |
+    */
+
+    'url' => env('APP_URL', 'http://localhost'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Timezone
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify the default timezone for your application, which
+    | will be used by the PHP date and date-time functions. The timezone
+    | is set to "UTC" by default as it is suitable for most use cases.
+    |
+    */
+
+    'timezone' => 'UTC',
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Locale Configuration
+    |--------------------------------------------------------------------------
+    |
+    | The application locale determines the default locale that will be used
+    | by Laravel's translation / localization methods. This option can be
+    | set to any locale for which you plan to have translation strings.
+    |
+    */
+
+    'locale' => env('APP_LOCALE', 'en'),
+
+    'fallback_locale' => env('APP_FALLBACK_LOCALE', 'en'),
+
+    'faker_locale' => env('APP_FAKER_LOCALE', 'en_US'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Encryption Key
+    |--------------------------------------------------------------------------
+    |
+    | This key is utilized by Laravel's encryption services and should be set
+    | to a random, 32 character string to ensure that all encrypted values
+    | are secure. You should do this prior to deploying the application.
+    |
+    */
+
+    'cipher' => 'AES-256-CBC',
+
+    'key' => env('APP_KEY'),
+
+    'previous_keys' => [
+        ...array_filter(
+            explode(',', (string) env('APP_PREVIOUS_KEYS', ''))
+        ),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Maintenance Mode Driver
+    |--------------------------------------------------------------------------
+    |
+    | These configuration options determine the driver used to determine and
+    | manage Laravel's "maintenance mode" status. The "cache" driver will
+    | allow maintenance mode to be controlled across multiple machines.
+    |
+    | Supported drivers: "file", "cache", "array"
+    |
+    */
+
+    'maintenance' => [
+        'driver' => env('APP_MAINTENANCE_DRIVER', 'file'),
+        'store' => env('APP_MAINTENANCE_STORE', 'database'),
+    ],
+
+];

config/auth.php

@@ -0,0 +1,117 @@
+<?php
+
+use App\Models\User;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Authentication Defaults
+    |--------------------------------------------------------------------------
+    |
+    | This option defines the default authentication "guard" and password
+    | reset "broker" for your application. You may change these values
+    | as required, but they're a perfect start for most applications.
+    |
+    */
+
+    'defaults' => [
+        'guard' => env('AUTH_GUARD', 'web'),
+        'passwords' => env('AUTH_PASSWORD_BROKER', 'users'),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Authentication Guards
+    |--------------------------------------------------------------------------
+    |
+    | Next, you may define every authentication guard for your application.
+    | Of course, a great default configuration has been defined for you
+    | which utilizes session storage plus the Eloquent user provider.
+    |
+    | All authentication guards have a user provider, which defines how the
+    | users are actually retrieved out of your database or other storage
+    | system used by the application. Typically, Eloquent is utilized.
+    |
+    | Supported: "session"
+    |
+    */
+
+    'guards' => [
+        'web' => [
+            'driver' => 'session',
+            'provider' => 'users',
+        ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | User Providers
+    |--------------------------------------------------------------------------
+    |
+    | All authentication guards have a user provider, which defines how the
+    | users are actually retrieved out of your database or other storage
+    | system used by the application. Typically, Eloquent is utilized.
+    |
+    | If you have multiple user tables or models you may configure multiple
+    | providers to represent the model / table. These providers may then
+    | be assigned to any extra authentication guards you have defined.
+    |
+    | Supported: "database", "eloquent"
+    |
+    */
+
+    'providers' => [
+        'users' => [
+            'driver' => 'eloquent',
+            'model' => env('AUTH_MODEL', User::class),
+        ],
+
+        // 'users' => [
+        //     'driver' => 'database',
+        //     'table' => 'users',
+        // ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Resetting Passwords
+    |--------------------------------------------------------------------------
+    |
+    | These configuration options specify the behavior of Laravel's password
+    | reset functionality, including the table utilized for token storage
+    | and the user provider that is invoked to actually retrieve users.
+    |
+    | The expiry time is the number of minutes that each reset token will be
+    | considered valid. This security feature keeps tokens short-lived so
+    | they have less time to be guessed. You may change this as needed.
+    |
+    | The throttle setting is the number of seconds a user must wait before
+    | generating more password reset tokens. This prevents the user from
+    | quickly generating a very large amount of password reset tokens.
+    |
+    */
+
+    'passwords' => [
+        'users' => [
+            'provider' => 'users',
+            'table' => env('AUTH_PASSWORD_RESET_TOKEN_TABLE', 'password_reset_tokens'),
+            'expire' => 60,
+            'throttle' => 60,
+        ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Password Confirmation Timeout
+    |--------------------------------------------------------------------------
+    |
+    | Here you may define the number of seconds before a password confirmation
+    | window expires and users are asked to re-enter their password via the
+    | confirmation screen. By default, the timeout lasts for three hours.
+    |
+    */
+
+    'password_timeout' => env('AUTH_PASSWORD_TIMEOUT', 10800),
+
+];

config/cache.php

@@ -0,0 +1,136 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Cache Store
+    |--------------------------------------------------------------------------
+    |
+    | This option controls the default cache store that will be used by the
+    | framework. This connection is utilized if another isn't explicitly
+    | specified when running a cache operation inside the application.
+    |
+    */
+
+    'default' => env('CACHE_STORE', 'database'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Cache Stores
+    |--------------------------------------------------------------------------
+    |
+    | Here you may define all of the cache "stores" for your application as
+    | well as their drivers. You may even define multiple stores for the
+    | same cache driver to group types of items stored in your caches.
+    |
+    | Supported drivers: "array", "database", "file", "memcached",
+    |                    "redis", "dynamodb", "storage", "octane",
+    |                    "session", "failover", "null"
+    |
+    */
+
+    'stores' => [
+
+        'array' => [
+            'driver' => 'array',
+            'serialize' => false,
+        ],
+
+        'database' => [
+            'driver' => 'database',
+            'connection' => env('DB_CACHE_CONNECTION'),
+            'table' => env('DB_CACHE_TABLE', 'cache'),
+            'lock_connection' => env('DB_CACHE_LOCK_CONNECTION'),
+            'lock_table' => env('DB_CACHE_LOCK_TABLE'),
+        ],
+
+        'file' => [
+            'driver' => 'file',
+            'path' => storage_path('framework/cache/data'),
+            'lock_path' => storage_path('framework/cache/data'),
+        ],
+
+        'storage' => [
+            'driver' => 'storage',
+            'disk' => env('CACHE_STORAGE_DISK'),
+            'path' => env('CACHE_STORAGE_PATH', 'framework/cache/data'),
+        ],
+
+        'memcached' => [
+            'driver' => 'memcached',
+            'persistent_id' => env('MEMCACHED_PERSISTENT_ID'),
+            'sasl' => [
+                env('MEMCACHED_USERNAME'),
+                env('MEMCACHED_PASSWORD'),
+            ],
+            'options' => [
+                // Memcached::OPT_CONNECT_TIMEOUT => 2000,
+            ],
+            'servers' => [
+                [
+                    'host' => env('MEMCACHED_HOST', '127.0.0.1'),
+                    'port' => env('MEMCACHED_PORT', 11211),
+                    'weight' => 100,
+                ],
+            ],
+        ],
+
+        'redis' => [
+            'driver' => 'redis',
+            'connection' => env('REDIS_CACHE_CONNECTION', 'cache'),
+            'lock_connection' => env('REDIS_CACHE_LOCK_CONNECTION', 'default'),
+        ],
+
+        'dynamodb' => [
+            'driver' => 'dynamodb',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+            'table' => env('DYNAMODB_CACHE_TABLE', 'cache'),
+            'endpoint' => env('DYNAMODB_ENDPOINT'),
+        ],
+
+        'octane' => [
+            'driver' => 'octane',
+        ],
+
+        'failover' => [
+            'driver' => 'failover',
+            'stores' => [
+                'database',
+                'array',
+            ],
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Cache Key Prefix
+    |--------------------------------------------------------------------------
+    |
+    | When utilizing the APC, database, memcached, Redis, and DynamoDB cache
+    | stores, there might be other applications using the same cache. For
+    | that reason, you may prefix every cache key to avoid collisions.
+    |
+    */
+
+    'prefix' => env('CACHE_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-cache-'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Serializable Classes
+    |--------------------------------------------------------------------------
+    |
+    | This value determines the classes that can be unserialized from cache
+    | storage. By default, no PHP classes will be unserialized from your
+    | cache to prevent gadget chain attacks if your APP_KEY is leaked.
+    |
+    */
+
+    'serializable_classes' => false,
+
+];

config/database.php

@@ -0,0 +1,184 @@
+<?php
+
+use Illuminate\Support\Str;
+use Pdo\Mysql;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Database Connection Name
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify which of the database connections below you wish
+    | to use as your default connection for database operations. This is
+    | the connection which will be utilized unless another connection
+    | is explicitly specified when you execute a query / statement.
+    |
+    */
+
+    'default' => env('DB_CONNECTION', 'sqlite'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Database Connections
+    |--------------------------------------------------------------------------
+    |
+    | Below are all of the database connections defined for your application.
+    | An example configuration is provided for each database system which
+    | is supported by Laravel. You're free to add / remove connections.
+    |
+    */
+
+    'connections' => [
+
+        'sqlite' => [
+            'driver' => 'sqlite',
+            'url' => env('DB_URL'),
+            'database' => env('DB_DATABASE', database_path('database.sqlite')),
+            'prefix' => '',
+            'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true),
+            'busy_timeout' => null,
+            'journal_mode' => null,
+            'synchronous' => null,
+            'transaction_mode' => 'DEFERRED',
+        ],
+
+        'mysql' => [
+            'driver' => 'mysql',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '3306'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'unix_socket' => env('DB_SOCKET', ''),
+            'charset' => env('DB_CHARSET', 'utf8mb4'),
+            'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'strict' => true,
+            'engine' => null,
+            'options' => extension_loaded('pdo_mysql') ? array_filter([
+                Mysql::ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
+            ]) : [],
+        ],
+
+        'mariadb' => [
+            'driver' => 'mariadb',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '3306'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'unix_socket' => env('DB_SOCKET', ''),
+            'charset' => env('DB_CHARSET', 'utf8mb4'),
+            'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'strict' => true,
+            'engine' => null,
+            'options' => extension_loaded('pdo_mysql') ? array_filter([
+                Mysql::ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
+            ]) : [],
+        ],
+
+        'pgsql' => [
+            'driver' => 'pgsql',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '5432'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'charset' => env('DB_CHARSET', 'utf8'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'search_path' => 'public',
+            'sslmode' => env('DB_SSLMODE', 'prefer'),
+        ],
+
+        'sqlsrv' => [
+            'driver' => 'sqlsrv',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', 'localhost'),
+            'port' => env('DB_PORT', '1433'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'charset' => env('DB_CHARSET', 'utf8'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            // 'encrypt' => env('DB_ENCRYPT', 'yes'),
+            // 'trust_server_certificate' => env('DB_TRUST_SERVER_CERTIFICATE', 'false'),
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Migration Repository Table
+    |--------------------------------------------------------------------------
+    |
+    | This table keeps track of all the migrations that have already run for
+    | your application. Using this information, we can determine which of
+    | the migrations on disk haven't actually been run on the database.
+    |
+    */
+
+    'migrations' => [
+        'table' => 'migrations',
+        'update_date_on_publish' => true,
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Redis Databases
+    |--------------------------------------------------------------------------
+    |
+    | Redis is an open source, fast, and advanced key-value store that also
+    | provides a richer body of commands than a typical key-value system
+    | such as Memcached. You may define your connection settings here.
+    |
+    */
+
+    'redis' => [
+
+        'client' => env('REDIS_CLIENT', 'phpredis'),
+
+        'options' => [
+            'cluster' => env('REDIS_CLUSTER', 'redis'),
+            'prefix' => env('REDIS_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-database-'),
+            'persistent' => env('REDIS_PERSISTENT', false),
+        ],
+
+        'default' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => env('REDIS_DB', '0'),
+            'max_retries' => env('REDIS_MAX_RETRIES', 3),
+            'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'),
+            'backoff_base' => env('REDIS_BACKOFF_BASE', 100),
+            'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000),
+        ],
+
+        'cache' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => env('REDIS_CACHE_DB', '1'),
+            'max_retries' => env('REDIS_MAX_RETRIES', 3),
+            'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'),
+            'backoff_base' => env('REDIS_BACKOFF_BASE', 100),
+            'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000),
+        ],
+
+    ],
+
+];

config/filesystems.php

@@ -0,0 +1,80 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Filesystem Disk
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify the default filesystem disk that should be used
+    | by the framework. The "local" disk, as well as a variety of cloud
+    | based disks are available to your application for file storage.
+    |
+    */
+
+    'default' => env('FILESYSTEM_DISK', 'local'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Filesystem Disks
+    |--------------------------------------------------------------------------
+    |
+    | Below you may configure as many filesystem disks as necessary, and you
+    | may even configure multiple disks for the same driver. Examples for
+    | most supported storage drivers are configured here for reference.
+    |
+    | Supported drivers: "local", "ftp", "sftp", "s3"
+    |
+    */
+
+    'disks' => [
+
+        'local' => [
+            'driver' => 'local',
+            'root' => storage_path('app/private'),
+            'serve' => true,
+            'throw' => false,
+            'report' => false,
+        ],
+
+        'public' => [
+            'driver' => 'local',
+            'root' => storage_path('app/public'),
+            'url' => rtrim(env('APP_URL', 'http://localhost'), '/').'/storage',
+            'visibility' => 'public',
+            'throw' => false,
+            'report' => false,
+        ],
+
+        's3' => [
+            'driver' => 's3',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'region' => env('AWS_DEFAULT_REGION'),
+            'bucket' => env('AWS_BUCKET'),
+            'url' => env('AWS_URL'),
+            'endpoint' => env('AWS_ENDPOINT'),
+            'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
+            'throw' => false,
+            'report' => false,
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Symbolic Links
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure the symbolic links that will be created when the
+    | `storage:link` Artisan command is executed. The array keys should be
+    | the locations of the links and the values should be their targets.
+    |
+    */
+
+    'links' => [
+        public_path('storage') => storage_path('app/public'),
+    ],
+
+];

config/logging.php

@@ -0,0 +1,140 @@
+<?php
+
+use Monolog\Handler\NullHandler;
+use Monolog\Handler\StreamHandler;
+use Monolog\Handler\SyslogUdpHandler;
+use Monolog\Processor\PsrLogMessageProcessor;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Log Channel
+    |--------------------------------------------------------------------------
+    |
+    | This option defines the default log channel that is utilized to write
+    | messages to your logs. The value provided here should match one of
+    | the channels present in the list of "channels" configured below.
+    |
+    */
+
+    'default' => env('LOG_CHANNEL', 'stack'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Deprecations Log Channel
+    |--------------------------------------------------------------------------
+    |
+    | This option controls the log channel that should be used to log warnings
+    | regarding deprecated PHP and library features. This allows you to get
+    | your application ready for upcoming major versions of dependencies.
+    |
+    */
+
+    'deprecations' => [
+        'channel' => env('LOG_DEPRECATIONS_CHANNEL', 'null'),
+        'trace' => env('LOG_DEPRECATIONS_TRACE', false),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Log Channels
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure the log channels for your application. Laravel
+    | utilizes the Monolog PHP logging library, which includes a variety
+    | of powerful log handlers and formatters that you're free to use.
+    |
+    | Available drivers: "single", "daily", "monthly", "slack", "syslog",
+    |                    "errorlog", "monolog", "custom", "stack"
+    |
+    */
+
+    'channels' => [
+
+        'stack' => [
+            'driver' => 'stack',
+            'channels' => explode(',', (string) env('LOG_STACK', 'single')),
+            'ignore_exceptions' => false,
+        ],
+
+        'single' => [
+            'driver' => 'single',
+            'path' => storage_path('logs/laravel.log'),
+            'level' => env('LOG_LEVEL', 'debug'),
+            'replace_placeholders' => true,
+        ],
+
+        'daily' => [
+            'driver' => 'daily',
+            'path' => storage_path('logs/laravel.log'),
+            'level' => env('LOG_LEVEL', 'debug'),
+            'max_files' => env('LOG_DAILY_DAYS', 14),
+            'replace_placeholders' => true,
+        ],
+
+        'monthly' => [
+            'driver' => 'monthly',
+            'path' => storage_path('logs/laravel.log'),
+            'level' => env('LOG_LEVEL', 'debug'),
+            'max_files' => 3,
+            'replace_placeholders' => true,
+        ],
+
+        'slack' => [
+            'driver' => 'slack',
+            'url' => env('LOG_SLACK_WEBHOOK_URL'),
+            'username' => env('LOG_SLACK_USERNAME', env('APP_NAME', 'Laravel')),
+            'emoji' => env('LOG_SLACK_EMOJI', ':boom:'),
+            'level' => env('LOG_LEVEL', 'critical'),
+            'replace_placeholders' => true,
+        ],
+
+        'papertrail' => [
+            'driver' => 'monolog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'handler' => env('LOG_PAPERTRAIL_HANDLER', SyslogUdpHandler::class),
+            'handler_with' => [
+                'host' => env('PAPERTRAIL_URL'),
+                'port' => env('PAPERTRAIL_PORT'),
+                'connectionString' => 'tls://'.env('PAPERTRAIL_URL').':'.env('PAPERTRAIL_PORT'),
+            ],
+            'processors' => [PsrLogMessageProcessor::class],
+        ],
+
+        'stderr' => [
+            'driver' => 'monolog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'handler' => StreamHandler::class,
+            'handler_with' => [
+                'stream' => 'php://stderr',
+            ],
+            'formatter' => env('LOG_STDERR_FORMATTER'),
+            'processors' => [PsrLogMessageProcessor::class],
+        ],
+
+        'syslog' => [
+            'driver' => 'syslog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'facility' => env('LOG_SYSLOG_FACILITY', LOG_USER),
+            'replace_placeholders' => true,
+        ],
+
+        'errorlog' => [
+            'driver' => 'errorlog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'replace_placeholders' => true,
+        ],
+
+        'null' => [
+            'driver' => 'monolog',
+            'handler' => NullHandler::class,
+        ],
+
+        'emergency' => [
+            'path' => storage_path('logs/laravel.log'),
+        ],
+
+    ],
+
+];

config/mail.php

@@ -0,0 +1,118 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Mailer
+    |--------------------------------------------------------------------------
+    |
+    | This option controls the default mailer that is used to send all email
+    | messages unless another mailer is explicitly specified when sending
+    | the message. All additional mailers can be configured within the
+    | "mailers" array. Examples of each type of mailer are provided.
+    |
+    */
+
+    'default' => env('MAIL_MAILER', 'log'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Mailer Configurations
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure all of the mailers used by your application plus
+    | their respective settings. Several examples have been configured for
+    | you and you are free to add your own as your application requires.
+    |
+    | Laravel supports a variety of mail "transport" drivers that can be used
+    | when delivering an email. You may specify which one you're using for
+    | your mailers below. You may also add additional mailers if needed.
+    |
+    | Supported: "smtp", "sendmail", "mailgun", "ses", "ses-v2",
+    |            "postmark", "resend", "log", "array",
+    |            "failover", "roundrobin"
+    |
+    */
+
+    'mailers' => [
+
+        'smtp' => [
+            'transport' => 'smtp',
+            'scheme' => env('MAIL_SCHEME'),
+            'url' => env('MAIL_URL'),
+            'host' => env('MAIL_HOST', '127.0.0.1'),
+            'port' => env('MAIL_PORT', 2525),
+            'username' => env('MAIL_USERNAME'),
+            'password' => env('MAIL_PASSWORD'),
+            'timeout' => null,
+            'local_domain' => env('MAIL_EHLO_DOMAIN', parse_url((string) env('APP_URL', 'http://localhost'), PHP_URL_HOST)),
+        ],
+
+        'ses' => [
+            'transport' => 'ses',
+        ],
+
+        'postmark' => [
+            'transport' => 'postmark',
+            // 'message_stream_id' => env('POSTMARK_MESSAGE_STREAM_ID'),
+            // 'client' => [
+            //     'timeout' => 5,
+            // ],
+        ],
+
+        'resend' => [
+            'transport' => 'resend',
+        ],
+
+        'sendmail' => [
+            'transport' => 'sendmail',
+            'path' => env('MAIL_SENDMAIL_PATH', '/usr/sbin/sendmail -bs -i'),
+        ],
+
+        'log' => [
+            'transport' => 'log',
+            'channel' => env('MAIL_LOG_CHANNEL'),
+        ],
+
+        'array' => [
+            'transport' => 'array',
+        ],
+
+        'failover' => [
+            'transport' => 'failover',
+            'mailers' => [
+                'smtp',
+                'log',
+            ],
+            'retry_after' => 60,
+        ],
+
+        'roundrobin' => [
+            'transport' => 'roundrobin',
+            'mailers' => [
+                'ses',
+                'postmark',
+            ],
+            'retry_after' => 60,
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Global "From" Address
+    |--------------------------------------------------------------------------
+    |
+    | You may wish for all emails sent by your application to be sent from
+    | the same address. Here you may specify a name and address that is
+    | used globally for all emails that are sent by your application.
+    |
+    */
+
+    'from' => [
+        'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
+        'name' => env('MAIL_FROM_NAME', env('APP_NAME', 'Laravel')),
+    ],
+
+];

config/queue.php

@@ -0,0 +1,129 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Queue Connection Name
+    |--------------------------------------------------------------------------
+    |
+    | Laravel's queue supports a variety of backends via a single, unified
+    | API, giving you convenient access to each backend using identical
+    | syntax for each. The default queue connection is defined below.
+    |
+    */
+
+    'default' => env('QUEUE_CONNECTION', 'database'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Queue Connections
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure the connection options for every queue backend
+    | used by your application. An example configuration is provided for
+    | each backend supported by Laravel. You're also free to add more.
+    |
+    | Drivers: "sync", "database", "beanstalkd", "sqs", "redis",
+    |          "deferred", "background", "failover", "null"
+    |
+    */
+
+    'connections' => [
+
+        'sync' => [
+            'driver' => 'sync',
+        ],
+
+        'database' => [
+            'driver' => 'database',
+            'connection' => env('DB_QUEUE_CONNECTION'),
+            'table' => env('DB_QUEUE_TABLE', 'jobs'),
+            'queue' => env('DB_QUEUE', 'default'),
+            'retry_after' => (int) env('DB_QUEUE_RETRY_AFTER', 90),
+            'after_commit' => false,
+        ],
+
+        'beanstalkd' => [
+            'driver' => 'beanstalkd',
+            'host' => env('BEANSTALKD_QUEUE_HOST', 'localhost'),
+            'queue' => env('BEANSTALKD_QUEUE', 'default'),
+            'retry_after' => (int) env('BEANSTALKD_QUEUE_RETRY_AFTER', 90),
+            'block_for' => 0,
+            'after_commit' => false,
+        ],
+
+        'sqs' => [
+            'driver' => 'sqs',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'),
+            'queue' => env('SQS_QUEUE', 'default'),
+            'suffix' => env('SQS_SUFFIX'),
+            'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+            'after_commit' => false,
+        ],
+
+        'redis' => [
+            'driver' => 'redis',
+            'connection' => env('REDIS_QUEUE_CONNECTION', 'default'),
+            'queue' => env('REDIS_QUEUE', 'default'),
+            'retry_after' => (int) env('REDIS_QUEUE_RETRY_AFTER', 90),
+            'block_for' => null,
+            'after_commit' => false,
+        ],
+
+        'deferred' => [
+            'driver' => 'deferred',
+        ],
+
+        'background' => [
+            'driver' => 'background',
+        ],
+
+        'failover' => [
+            'driver' => 'failover',
+            'connections' => [
+                'database',
+                'deferred',
+            ],
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Job Batching
+    |--------------------------------------------------------------------------
+    |
+    | The following options configure the database and table that store job
+    | batching information. These options can be updated to any database
+    | connection and table which has been defined by your application.
+    |
+    */
+
+    'batching' => [
+        'database' => env('DB_CONNECTION', 'sqlite'),
+        'table' => 'job_batches',
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Failed Queue Jobs
+    |--------------------------------------------------------------------------
+    |
+    | These options configure the behavior of failed queue job logging so you
+    | can control how and where failed jobs are stored. Laravel ships with
+    | support for storing failed jobs in a simple file or in a database.
+    |
+    | Supported drivers: "database-uuids", "dynamodb", "file", "null"
+    |
+    */
+
+    'failed' => [
+        'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'),
+        'database' => env('DB_CONNECTION', 'sqlite'),
+        'table' => 'failed_jobs',
+    ],
+
+];

config/runware.php

@@ -0,0 +1,49 @@
+<?php
+
+return [
+
+    'api_key' => env('RUNWARE_API_KEY'),
+
+    'base_url' => env('RUNWARE_BASE_URL', 'https://api.runware.ai/v1'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Budget
+    |--------------------------------------------------------------------------
+    |
+    | Hard monthly spending cap enforced by App\Services\Runware\BudgetGuard
+    | before every batch. Spend is tracked in USD (Runware's billing currency)
+    | and converted to EUR using the cached live rate from CurrencyRateService,
+    | falling back to usd_eur_fallback_rate when no live rate is cached yet.
+    |
+    */
+
+    'monthly_cap_eur' => (float) env('RUNWARE_MONTHLY_CAP_EUR', 20),
+
+    'usd_eur_fallback_rate' => (float) env('RUNWARE_USD_EUR_FALLBACK_RATE', 0.92),
+
+    // Extra headroom subtracted from the cap when checking pre-flight cost
+    // estimates, to absorb FX drift and estimate error.
+    'safety_margin' => (float) env('RUNWARE_SAFETY_MARGIN', 0.10),
+
+    // Fraction of the cap at which a warning notification fires.
+    'warn_threshold' => (float) env('RUNWARE_WARN_THRESHOLD', 0.80),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default models
+    |--------------------------------------------------------------------------
+    |
+    | Empty by default: App\Services\Runware\ModelCatalog discovers the
+    | cheapest model per modality via Runware's model search API and caches
+    | it daily. Set any of these to override the discovered default.
+    |
+    */
+
+    'default_models' => [
+        'image' => env('RUNWARE_IMAGE_MODEL'),
+        'video' => env('RUNWARE_VIDEO_MODEL'),
+        'text' => env('RUNWARE_TEXT_MODEL'),
+    ],
+
+];

config/services.php

@@ -0,0 +1,38 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Third Party Services
+    |--------------------------------------------------------------------------
+    |
+    | This file is for storing the credentials for third party services such
+    | as Resend, Postmark, AWS, and more. This file provides the de facto
+    | location for this type of information, allowing packages to have
+    | a conventional file to locate the various service credentials.
+    |
+    */
+
+    'postmark' => [
+        'key' => env('POSTMARK_API_KEY'),
+    ],
+
+    'resend' => [
+        'key' => env('RESEND_API_KEY'),
+    ],
+
+    'ses' => [
+        'key' => env('AWS_ACCESS_KEY_ID'),
+        'secret' => env('AWS_SECRET_ACCESS_KEY'),
+        'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+    ],
+
+    'slack' => [
+        'notifications' => [
+            'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'),
+            'channel' => env('SLACK_BOT_USER_DEFAULT_CHANNEL'),
+        ],
+    ],
+
+];

config/session.php

@@ -0,0 +1,233 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Session Driver
+    |--------------------------------------------------------------------------
+    |
+    | This option determines the default session driver that is utilized for
+    | incoming requests. Laravel supports a variety of storage options to
+    | persist session data. Database storage is a great default choice.
+    |
+    | Supported: "file", "cookie", "database", "memcached",
+    |            "redis", "dynamodb", "array"
+    |
+    */
+
+    'driver' => env('SESSION_DRIVER', 'database'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Lifetime
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify the number of minutes that you wish the session
+    | to be allowed to remain idle before it expires. If you want them
+    | to expire immediately when the browser is closed then you may
+    | indicate that via the expire_on_close configuration option.
+    |
+    */
+
+    'lifetime' => (int) env('SESSION_LIFETIME', 120),
+
+    'expire_on_close' => env('SESSION_EXPIRE_ON_CLOSE', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Encryption
+    |--------------------------------------------------------------------------
+    |
+    | This option allows you to easily specify that all of your session data
+    | should be encrypted before it's stored. All encryption is performed
+    | automatically by Laravel and you may use the session like normal.
+    |
+    */
+
+    'encrypt' => env('SESSION_ENCRYPT', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session File Location
+    |--------------------------------------------------------------------------
+    |
+    | When utilizing the "file" session driver, the session files are placed
+    | on disk. The default storage location is defined here; however, you
+    | are free to provide another location where they should be stored.
+    |
+    */
+
+    'files' => storage_path('framework/sessions'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Database Connection
+    |--------------------------------------------------------------------------
+    |
+    | When using the "database" or "redis" session drivers, you may specify a
+    | connection that should be used to manage these sessions. This should
+    | correspond to a connection in your database configuration options.
+    |
+    */
+
+    'connection' => env('SESSION_CONNECTION'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Database Table
+    |--------------------------------------------------------------------------
+    |
+    | When using the "database" session driver, you may specify the table to
+    | be used to store sessions. Of course, a sensible default is defined
+    | for you; however, you're welcome to change this to another table.
+    |
+    */
+
+    'table' => env('SESSION_TABLE', 'sessions'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cache Store
+    |--------------------------------------------------------------------------
+    |
+    | When using one of the framework's cache driven session backends, you may
+    | define the cache store which should be used to store the session data
+    | between requests. This must match one of your defined cache stores.
+    |
+    | Affects: "dynamodb", "memcached", "redis"
+    |
+    */
+
+    'store' => env('SESSION_STORE'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Sweeping Lottery
+    |--------------------------------------------------------------------------
+    |
+    | Some session drivers must manually sweep their storage location to get
+    | rid of old sessions from storage. Here are the chances that it will
+    | happen on a given request. By default, the odds are 2 out of 100.
+    |
+    */
+
+    'lottery' => [2, 100],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cookie Name
+    |--------------------------------------------------------------------------
+    |
+    | Here you may change the name of the session cookie that is created by
+    | the framework. Typically, you should not need to change this value
+    | since doing so does not grant a meaningful security improvement.
+    |
+    */
+
+    'cookie' => env(
+        'SESSION_COOKIE',
+        Str::slug((string) env('APP_NAME', 'laravel')).'-session'
+    ),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cookie Path
+    |--------------------------------------------------------------------------
+    |
+    | The session cookie path determines the path for which the cookie will
+    | be regarded as available. Typically, this will be the root path of
+    | your application, but you're free to change this when necessary.
+    |
+    */
+
+    'path' => env('SESSION_PATH', '/'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cookie Domain
+    |--------------------------------------------------------------------------
+    |
+    | This value determines the domain and subdomains the session cookie is
+    | available to. By default, the cookie will be available to the root
+    | domain without subdomains. Typically, this shouldn't be changed.
+    |
+    */
+
+    'domain' => env('SESSION_DOMAIN'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | HTTPS Only Cookies
+    |--------------------------------------------------------------------------
+    |
+    | By setting this option to true, session cookies will only be sent back
+    | to the server if the browser has a HTTPS connection. This will keep
+    | the cookie from being sent to you when it can't be done securely.
+    |
+    */
+
+    'secure' => env('SESSION_SECURE_COOKIE'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | HTTP Access Only
+    |--------------------------------------------------------------------------
+    |
+    | Setting this value to true will prevent JavaScript from accessing the
+    | value of the cookie and the cookie will only be accessible through
+    | the HTTP protocol. It's unlikely you should disable this option.
+    |
+    */
+
+    'http_only' => env('SESSION_HTTP_ONLY', true),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Same-Site Cookies
+    |--------------------------------------------------------------------------
+    |
+    | This option determines how your cookies behave when cross-site requests
+    | take place, and can be used to mitigate CSRF attacks. By default, we
+    | will set this value to "lax" to permit secure cross-site requests.
+    |
+    | See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value
+    |
+    | Supported: "lax", "strict", "none", null
+    |
+    */
+
+    'same_site' => env('SESSION_SAME_SITE', 'lax'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Partitioned Cookies
+    |--------------------------------------------------------------------------
+    |
+    | Setting this value to true will tie the cookie to the top-level site for
+    | a cross-site context. Partitioned cookies are accepted by the browser
+    | when flagged "secure" and the Same-Site attribute is set to "none".
+    |
+    */
+
+    'partitioned' => env('SESSION_PARTITIONED_COOKIE', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Serialization
+    |--------------------------------------------------------------------------
+    |
+    | This value controls the serialization strategy for session data, which
+    | is JSON by default. Setting this to "php" allows the storage of PHP
+    | objects in the session but can make an application vulnerable to
+    | "gadget chain" serialization attacks if the APP_KEY is leaked.
+    |
+    | Supported: "json", "php"
+    |
+    */
+
+    'serialization' => 'json',
+
+];

database/.gitignore

@@ -0,0 +1 @@
+*.sqlite*

database/factories/UserFactory.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Str;
+
+/**
+ * @extends Factory<User>
+ */
+class UserFactory extends Factory
+{
+    /**
+     * The current password being used by the factory.
+     */
+    protected static ?string $password;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'name' => fake()->name(),
+            'email' => fake()->unique()->safeEmail(),
+            'email_verified_at' => now(),
+            'password' => static::$password ??= Hash::make('password'),
+            'remember_token' => Str::random(10),
+        ];
+    }
+
+    /**
+     * Indicate that the model's email address should be unverified.
+     */
+    public function unverified(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'email_verified_at' => null,
+        ]);
+    }
+}

database/migrations/0001_01_01_000000_create_users_table.php

@@ -0,0 +1,49 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('users', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('email')->unique();
+            $table->timestamp('email_verified_at')->nullable();
+            $table->string('password');
+            $table->rememberToken();
+            $table->timestamps();
+        });
+
+        Schema::create('password_reset_tokens', function (Blueprint $table) {
+            $table->string('email')->primary();
+            $table->string('token');
+            $table->timestamp('created_at')->nullable();
+        });
+
+        Schema::create('sessions', function (Blueprint $table) {
+            $table->string('id')->primary();
+            $table->foreignId('user_id')->nullable()->index();
+            $table->string('ip_address', 45)->nullable();
+            $table->text('user_agent')->nullable();
+            $table->longText('payload');
+            $table->integer('last_activity')->index();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('users');
+        Schema::dropIfExists('password_reset_tokens');
+        Schema::dropIfExists('sessions');
+    }
+};

database/migrations/0001_01_01_000001_create_cache_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('cache', function (Blueprint $table) {
+            $table->string('key')->primary();
+            $table->mediumText('value');
+            $table->bigInteger('expiration')->index();
+        });
+
+        Schema::create('cache_locks', function (Blueprint $table) {
+            $table->string('key')->primary();
+            $table->string('owner');
+            $table->bigInteger('expiration')->index();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('cache');
+        Schema::dropIfExists('cache_locks');
+    }
+};

database/migrations/0001_01_01_000002_create_jobs_table.php

@@ -0,0 +1,59 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('jobs', function (Blueprint $table) {
+            $table->id();
+            $table->string('queue')->index();
+            $table->longText('payload');
+            $table->unsignedSmallInteger('attempts');
+            $table->unsignedInteger('reserved_at')->nullable();
+            $table->unsignedInteger('available_at');
+            $table->unsignedInteger('created_at');
+        });
+
+        Schema::create('job_batches', function (Blueprint $table) {
+            $table->string('id')->primary();
+            $table->string('name');
+            $table->integer('total_jobs');
+            $table->integer('pending_jobs');
+            $table->integer('failed_jobs');
+            $table->longText('failed_job_ids');
+            $table->mediumText('options')->nullable();
+            $table->integer('cancelled_at')->nullable();
+            $table->integer('created_at');
+            $table->integer('finished_at')->nullable();
+        });
+
+        Schema::create('failed_jobs', function (Blueprint $table) {
+            $table->id();
+            $table->string('uuid')->unique();
+            $table->string('connection');
+            $table->string('queue');
+            $table->longText('payload');
+            $table->longText('exception');
+            $table->timestamp('failed_at')->useCurrent();
+
+            $table->index(['connection', 'queue', 'failed_at']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('jobs');
+        Schema::dropIfExists('job_batches');
+        Schema::dropIfExists('failed_jobs');
+    }
+};

database/migrations/2026_09_23_000001_create_runware_models_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('runware_models', function (Blueprint $table) {
+            $table->id();
+            $table->enum('modality', ['image', 'video', 'text']);
+            $table->string('air_id');
+            $table->string('label');
+            // Price is always expressed per the unit Runware bills that
+            // modality in: per generated image, per second of video, or
+            // per 1M tokens (combined input+output approximation) for text.
+            $table->enum('unit', ['per_image', 'per_second', 'per_million_tokens']);
+            $table->decimal('price_usd', 10, 6);
+            $table->boolean('is_default')->default(false);
+            $table->boolean('active')->default(true);
+            $table->timestamps();
+
+            $table->unique(['modality', 'air_id']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('runware_models');
+    }
+};

database/migrations/2026_09_23_000002_create_generations_table.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('generations', function (Blueprint $table) {
+            $table->id();
+            $table->uuid('batch_id')->nullable()->index();
+            $table->enum('type', ['image', 'video', 'text']);
+            $table->string('model');
+            $table->text('prompt')->nullable();
+            $table->json('params')->nullable();
+            $table->enum('status', ['pending', 'processing', 'completed', 'failed'])->default('pending');
+            $table->uuid('runware_task_uuid')->nullable()->unique();
+            $table->decimal('cost_usd', 10, 6)->nullable();
+            $table->decimal('cost_eur', 10, 6)->nullable();
+            $table->boolean('cost_is_estimated')->default(false);
+            $table->string('output_path')->nullable();
+            $table->longText('output_text')->nullable();
+            $table->text('error')->nullable();
+            $table->timestamps();
+
+            $table->index('created_at');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('generations');
+    }
+};

database/seeders/DatabaseSeeder.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\User;
+use Illuminate\Database\Console\Seeds\WithoutModelEvents;
+use Illuminate\Database\Seeder;
+
+class DatabaseSeeder extends Seeder
+{
+    use WithoutModelEvents;
+
+    /**
+     * Seed the application's database.
+     */
+    public function run(): void
+    {
+        // User::factory(10)->create();
+
+        User::factory()->create([
+            'name' => 'Test User',
+            'email' => 'test@example.com',
+        ]);
+    }
+}

package.json

@@ -0,0 +1,19 @@
+{
+    "$schema": "https://www.schemastore.org/package.json",
+    "private": true,
+    "type": "module",
+    "scripts": {
+        "build": "vite build",
+        "dev": "vite"
+    },
+    "devDependencies": {
+        "@tailwindcss/vite": "^4.0.0",
+        "concurrently": "^10.0.3",
+        "laravel-vite-plugin": "^3.1",
+        "tailwindcss": "^4.0.0",
+        "vite": "^8.0.0"
+    },
+    "optionalDependencies": {
+        "@laravel/multiplex": "^0.4.1"
+    }
+}

phpunit.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+>
+    <testsuites>
+        <testsuite name="Unit">
+            <directory>tests/Unit</directory>
+        </testsuite>
+        <testsuite name="Feature">
+            <directory>tests/Feature</directory>
+        </testsuite>
+    </testsuites>
+    <source>
+        <include>
+            <directory>app</directory>
+        </include>
+    </source>
+    <php>
+        <env name="APP_ENV" value="testing"/>
+        <env name="APP_MAINTENANCE_DRIVER" value="file"/>
+        <env name="BCRYPT_ROUNDS" value="4"/>
+        <env name="BROADCAST_CONNECTION" value="null"/>
+        <env name="CACHE_STORE" value="array"/>
+        <env name="DB_CONNECTION" value="sqlite"/>
+        <env name="DB_DATABASE" value=":memory:"/>
+        <env name="DB_URL" value=""/>
+        <env name="MAIL_MAILER" value="array"/>
+        <env name="QUEUE_CONNECTION" value="sync"/>
+        <env name="SESSION_DRIVER" value="array"/>
+        <env name="PULSE_ENABLED" value="false"/>
+        <env name="TELESCOPE_ENABLED" value="false"/>
+        <env name="NIGHTWATCH_ENABLED" value="false"/>
+    </php>
+</phpunit>

public/.htaccess

@@ -0,0 +1,25 @@
+<IfModule mod_rewrite.c>
+    <IfModule mod_negotiation.c>
+        Options -MultiViews -Indexes
+    </IfModule>
+
+    RewriteEngine On
+
+    # Handle Authorization Header
+    RewriteCond %{HTTP:Authorization} .
+    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
+
+    # Handle X-XSRF-Token Header
+    RewriteCond %{HTTP:x-xsrf-token} .
+    RewriteRule .* - [E=HTTP_X_XSRF_TOKEN:%{HTTP:X-XSRF-Token}]
+
+    # Redirect Trailing Slashes If Not A Folder...
+    RewriteCond %{REQUEST_FILENAME} !-d
+    RewriteCond %{REQUEST_URI} (.+)/$
+    RewriteRule ^ %1 [L,R=301]
+
+    # Send Requests To Front Controller...
+    RewriteCond %{REQUEST_FILENAME} !-d
+    RewriteCond %{REQUEST_FILENAME} !-f
+    RewriteRule ^ index.php [L]
+</IfModule>

public/index.php

@@ -0,0 +1,20 @@
+<?php
+
+use Illuminate\Foundation\Application;
+use Illuminate\Http\Request;
+
+define('LARAVEL_START', microtime(true));
+
+// Determine if the application is in maintenance mode...
+if (file_exists($maintenance = __DIR__.'/../storage/framework/maintenance.php')) {
+    require $maintenance;
+}
+
+// Register the Composer autoloader...
+require __DIR__.'/../vendor/autoload.php';
+
+// Bootstrap Laravel and handle the request...
+/** @var Application $app */
+$app = require_once __DIR__.'/../bootstrap/app.php';
+
+$app->handleRequest(Request::capture());

public/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Disallow:

resources/css/app.css

@@ -0,0 +1,9 @@
+@import 'tailwindcss';
+
+@source '../../vendor/laravel/framework/src/Illuminate/Pagination/resources/views/*.blade.php';
+@source '../../storage/framework/views/*.php';
+
+@theme {
+    --font-sans: 'Instrument Sans', ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji',
+        'Segoe UI Symbol', 'Noto Color Emoji';
+}

resources/js/app.js

@@ -0,0 +1 @@
+//

resources/views/generations/index.blade.php

@@ -0,0 +1,111 @@
+@extends('layouts.app')
+
+@section('title', 'Generate — dreamstudio')
+
+@section('content')
+    <div class="mb-8 rounded-md border {{ $warnThresholdReached ? 'border-amber-300 bg-amber-50' : 'border-gray-200 bg-white' }} p-4">
+        <div class="flex items-center justify-between text-sm">
+            <span class="font-medium">Monthly Runware budget</span>
+            <span>{{ number_format($spentEur, 2) }}€ / {{ number_format($capEur, 2) }}€ spent · {{ number_format($remainingEur, 2) }}€ remaining</span>
+        </div>
+        <div class="mt-2 h-2 w-full overflow-hidden rounded-full bg-gray-100">
+            @php $pct = $capEur > 0 ? min(100, ($spentEur / $capEur) * 100) : 0; @endphp
+            <div class="h-full {{ $warnThresholdReached ? 'bg-amber-500' : 'bg-gray-800' }}" style="width: {{ $pct }}%"></div>
+        </div>
+        @if ($warnThresholdReached)
+            <p class="mt-2 text-sm text-amber-800">Approaching the monthly cap — new generations will be blocked once it's reached.</p>
+        @endif
+    </div>
+
+    <div class="mb-8 rounded-md border border-gray-200 bg-white p-6">
+        <h2 class="mb-4 text-base font-semibold">New generation</h2>
+        <form method="POST" action="{{ route('generations.store') }}" class="space-y-4">
+            @csrf
+
+            <div>
+                <label class="block text-sm font-medium">Type</label>
+                <select name="type" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm" onchange="document.querySelectorAll('[data-type-fields]').forEach(el => el.classList.toggle('hidden', el.dataset.typeFields !== this.value))">
+                    <option value="image">Image</option>
+                    <option value="video">Video</option>
+                    <option value="text">Text</option>
+                </select>
+            </div>
+
+            <div>
+                <label class="block text-sm font-medium">Model (optional — leave blank to use the default cheapest model)</label>
+                <select name="model" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">
+                    <option value="">Use default</option>
+                    @foreach ($models->flatten() as $model)
+                        <option value="{{ $model->air_id }}">[{{ $model->modality }}] {{ $model->label }} ({{ $model->air_id }}) — ${{ $model->price_usd }}/{{ $model->unit }}{{ $model->is_default ? ' · default' : '' }}</option>
+                    @endforeach
+                </select>
+            </div>
+
+            <div>
+                <label class="block text-sm font-medium">Prompt</label>
+                <textarea name="prompt" rows="3" required class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">{{ old('prompt') }}</textarea>
+            </div>
+
+            <div class="grid grid-cols-3 gap-4">
+                <div data-type-fields="image">
+                    <label class="block text-sm font-medium">Width</label>
+                    <input type="number" name="width" value="1024" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">
+                </div>
+                <div data-type-fields="image">
+                    <label class="block text-sm font-medium">Height</label>
+                    <input type="number" name="height" value="1024" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">
+                </div>
+                <div data-type-fields="video" class="hidden">
+                    <label class="block text-sm font-medium">Duration (seconds)</label>
+                    <input type="number" name="duration" value="5" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">
+                </div>
+            </div>
+
+            <button type="submit" class="rounded-md bg-gray-900 px-4 py-2 text-sm font-medium text-white hover:bg-gray-700">
+                Generate
+            </button>
+        </form>
+    </div>
+
+    <div class="rounded-md border border-gray-200 bg-white p-6">
+        <h2 class="mb-4 text-base font-semibold">History</h2>
+        <div class="divide-y divide-gray-100">
+            @forelse ($generations as $generation)
+                <div class="flex items-start justify-between gap-4 py-3">
+                    <div class="min-w-0 flex-1">
+                        <div class="flex items-center gap-2 text-sm">
+                            <span class="rounded bg-gray-100 px-2 py-0.5 font-medium uppercase">{{ $generation->type }}</span>
+                            <span class="rounded px-2 py-0.5 {{ match($generation->status) {
+                                'completed' => 'bg-green-100 text-green-800',
+                                'failed' => 'bg-red-100 text-red-800',
+                                default => 'bg-gray-100 text-gray-700',
+                            } }}">{{ $generation->status }}</span>
+                            <span class="text-gray-400">{{ $generation->model }}</span>
+                        </div>
+                        <p class="mt-1 truncate text-sm text-gray-700">{{ $generation->prompt }}</p>
+
+                        @if ($generation->type === 'image' && $generation->output_path)
+                            <img src="{{ Storage::url($generation->output_path) }}" class="mt-2 h-32 w-32 rounded object-cover">
+                        @elseif ($generation->type === 'video' && $generation->output_path)
+                            <video src="{{ Storage::url($generation->output_path) }}" controls class="mt-2 h-32 rounded"></video>
+                        @elseif ($generation->type === 'text' && $generation->output_text)
+                            <p class="mt-2 rounded bg-gray-50 p-2 text-sm text-gray-800">{{ Str::limit($generation->output_text, 300) }}</p>
+                        @elseif ($generation->error)
+                            <p class="mt-2 text-sm text-red-700">{{ $generation->error }}</p>
+                        @endif
+                    </div>
+                    <div class="shrink-0 text-right text-sm text-gray-500">
+                        @if ($generation->cost_eur !== null)
+                            <div>{{ number_format($generation->cost_eur, 4) }}€{{ $generation->cost_is_estimated ? ' (est.)' : '' }}</div>
+                        @endif
+                        <div class="text-xs">{{ $generation->created_at->diffForHumans() }}</div>
+                    </div>
+                </div>
+            @empty
+                <p class="py-6 text-center text-sm text-gray-500">No generations yet.</p>
+            @endforelse
+        </div>
+
+        {{ $generations->links() }}
+    </div>
+@endsection

resources/views/layouts/app.blade.php

@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>@yield('title', 'dreamstudio')</title>
+    @vite(['resources/css/app.css', 'resources/js/app.js'])
+</head>
+<body class="min-h-screen bg-gray-50 text-gray-900">
+    <nav class="border-b border-gray-200 bg-white">
+        <div class="mx-auto flex max-w-5xl items-center justify-between px-6 py-4">
+            <a href="{{ route('generations.index') }}" class="text-lg font-semibold">dreamstudio</a>
+            <div class="flex gap-4 text-sm">
+                <a href="{{ route('generations.index') }}" class="text-gray-600 hover:text-gray-900">Generate</a>
+                <a href="{{ route('runware-models.index') }}" class="text-gray-600 hover:text-gray-900">Models</a>
+            </div>
+        </div>
+    </nav>
+
+    <main class="mx-auto max-w-5xl px-6 py-8">
+        @if (session('status'))
+            <div class="mb-6 rounded-md border border-green-200 bg-green-50 px-4 py-3 text-sm text-green-800">
+                {{ session('status') }}
+            </div>
+        @endif
+
+        @if ($errors->any())
+            <div class="mb-6 rounded-md border border-red-200 bg-red-50 px-4 py-3 text-sm text-red-800">
+                <ul class="list-inside list-disc">
+                    @foreach ($errors->all() as $error)
+                        <li>{{ $error }}</li>
+                    @endforeach
+                </ul>
+            </div>
+        @endif
+
+        @yield('content')
+    </main>
+</body>
+</html>

resources/views/runware-models/index.blade.php

@@ -0,0 +1,95 @@
+@extends('layouts.app')
+
+@section('title', 'Runware Models — dreamstudio')
+
+@section('content')
+    <div class="mb-8 rounded-md border border-gray-200 bg-white p-6">
+        <h2 class="mb-4 text-base font-semibold">Add a model</h2>
+        <p class="mb-4 text-sm text-gray-500">
+            Runware doesn't expose pricing through its API, so add models here with the price from
+            <a href="https://runware.ai/pricing" class="underline" target="_blank" rel="noopener">runware.ai/pricing</a>.
+            The cheapest active model per type is automatically used as the default.
+        </p>
+        <form method="POST" action="{{ route('runware-models.store') }}" class="grid grid-cols-2 gap-4 sm:grid-cols-3">
+            @csrf
+            <div>
+                <label class="block text-sm font-medium">Type</label>
+                <select name="modality" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">
+                    <option value="image">Image</option>
+                    <option value="video">Video</option>
+                    <option value="text">Text</option>
+                </select>
+            </div>
+            <div>
+                <label class="block text-sm font-medium">Model ID (AIR)</label>
+                <input type="text" name="air_id" required placeholder="e.g. bfl:flux@3" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">
+            </div>
+            <div>
+                <label class="block text-sm font-medium">Label</label>
+                <input type="text" name="label" required placeholder="e.g. Flux 3" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">
+            </div>
+            <div>
+                <label class="block text-sm font-medium">Billed per</label>
+                <select name="unit" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">
+                    <option value="per_image">Image</option>
+                    <option value="per_second">Second (video)</option>
+                    <option value="per_million_tokens">1M tokens (text)</option>
+                </select>
+            </div>
+            <div>
+                <label class="block text-sm font-medium">Price (USD)</label>
+                <input type="number" step="0.000001" min="0" name="price_usd" required class="mt-1 block w-full rounded-md border-gray-300 shadow-sm">
+            </div>
+            <div class="flex items-end">
+                <button type="submit" class="rounded-md bg-gray-900 px-4 py-2 text-sm font-medium text-white hover:bg-gray-700">Add model</button>
+            </div>
+        </form>
+    </div>
+
+    <div class="rounded-md border border-gray-200 bg-white p-6">
+        <h2 class="mb-4 text-base font-semibold">Models</h2>
+        <table class="w-full text-left text-sm">
+            <thead>
+                <tr class="border-b border-gray-200 text-gray-500">
+                    <th class="py-2">Type</th>
+                    <th class="py-2">Label</th>
+                    <th class="py-2">AIR ID</th>
+                    <th class="py-2">Price</th>
+                    <th class="py-2">Default</th>
+                    <th class="py-2">Active</th>
+                    <th class="py-2"></th>
+                </tr>
+            </thead>
+            <tbody class="divide-y divide-gray-100">
+                @forelse ($models as $model)
+                    <tr>
+                        <td class="py-2 uppercase">{{ $model->modality }}</td>
+                        <td class="py-2">{{ $model->label }}</td>
+                        <td class="py-2 font-mono text-xs">{{ $model->air_id }}</td>
+                        <td class="py-2">${{ $model->price_usd }} / {{ $model->unit }}</td>
+                        <td class="py-2">{{ $model->is_default ? '✓' : '' }}</td>
+                        <td class="py-2">
+                            <form method="POST" action="{{ route('runware-models.update', $model) }}">
+                                @csrf
+                                @method('PATCH')
+                                <input type="hidden" name="active" value="{{ $model->active ? 0 : 1 }}">
+                                <button type="submit" class="underline">{{ $model->active ? 'Deactivate' : 'Activate' }}</button>
+                            </form>
+                        </td>
+                        <td class="py-2">
+                            <form method="POST" action="{{ route('runware-models.destroy', $model) }}" onsubmit="return confirm('Delete this model?')">
+                                @csrf
+                                @method('DELETE')
+                                <button type="submit" class="text-red-700 underline">Delete</button>
+                            </form>
+                        </td>
+                    </tr>
+                @empty
+                    <tr>
+                        <td colspan="7" class="py-6 text-center text-gray-500">No models yet — add one above.</td>
+                    </tr>
+                @endforelse
+            </tbody>
+        </table>
+    </div>
+@endsection

routes/console.php

@@ -0,0 +1,15 @@
+<?php
+
+use App\Services\Runware\CurrencyRateService;
+use Illuminate\Foundation\Inspiring;
+use Illuminate\Support\Facades\Artisan;
+use Illuminate\Support\Facades\Schedule;
+
+Artisan::command('inspire', function () {
+    $this->comment(Inspiring::quote());
+})->purpose('Display an inspiring quote');
+
+Schedule::call(fn () => app(CurrencyRateService::class)->refresh())
+    ->daily()
+    ->name('runware:refresh-usd-eur-rate')
+    ->onOneServer();

routes/web.php

@@ -0,0 +1,15 @@
+<?php
+
+use App\Http\Controllers\GenerationController;
+use App\Http\Controllers\RunwareModelController;
+use Illuminate\Support\Facades\Route;
+
+Route::redirect('/', '/generations');
+
+Route::get('/generations', [GenerationController::class, 'index'])->name('generations.index');
+Route::post('/generations', [GenerationController::class, 'store'])->name('generations.store');
+
+Route::get('/runware-models', [RunwareModelController::class, 'index'])->name('runware-models.index');
+Route::post('/runware-models', [RunwareModelController::class, 'store'])->name('runware-models.store');
+Route::patch('/runware-models/{runwareModel}', [RunwareModelController::class, 'update'])->name('runware-models.update');
+Route::delete('/runware-models/{runwareModel}', [RunwareModelController::class, 'destroy'])->name('runware-models.destroy');

storage/app/.gitignore

@@ -0,0 +1,4 @@
+*
+!private/
+!public/
+!.gitignore

storage/app/private/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/app/public/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/framework/.gitignore

@@ -0,0 +1,10 @@
+compiled.php
+config.php
+down
+events.scanned.php
+lsp-*.php
+maintenance.php
+routes.php
+routes.scanned.php
+schedule-*
+services.json

storage/framework/cache/.gitignore

@@ -0,0 +1,3 @@
+*
+!data/
+!.gitignore

storage/framework/cache/data/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/framework/sessions/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/framework/testing/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/framework/views/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/logs/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

tests/Feature/ExampleTest.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Tests\Feature;
+
+// use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class ExampleTest extends TestCase
+{
+    /**
+     * A basic test example.
+     */
+    public function test_the_application_returns_a_successful_response(): void
+    {
+        $response = $this->get('/');
+
+        $response->assertRedirect('/generations');
+    }
+}

tests/Feature/GenerationServiceTest.php

@@ -0,0 +1,109 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Exceptions\BudgetExceededException;
+use App\Models\Generation;
+use App\Models\RunwareModel;
+use App\Services\Runware\GenerationService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Storage;
+use Tests\TestCase;
+
+class GenerationServiceTest extends TestCase
+{
+    use RefreshDatabase;
+
+    protected function service(): GenerationService
+    {
+        return $this->app->make(GenerationService::class);
+    }
+
+    public function test_image_generation_records_actual_cost_and_downloads_file(): void
+    {
+        Storage::fake('public');
+        Http::fake([
+            'https://api.runware.ai/v1' => Http::response(['data' => [[
+                'taskType' => 'imageInference',
+                'taskUUID' => '11111111-1111-1111-1111-111111111111',
+                'imageURL' => 'https://cdn.example.com/out.jpg',
+                'cost' => 0.01,
+            ]]]),
+            'https://cdn.example.com/out.jpg' => Http::response('FAKEBYTES'),
+        ]);
+
+        RunwareModel::create([
+            'modality' => 'image', 'air_id' => 'a:cheap@1', 'label' => 'Cheap',
+            'unit' => 'per_image', 'price_usd' => 0.01, 'active' => true, 'is_default' => true,
+        ]);
+
+        $generation = $this->service()->createImage('a cat wearing a hat');
+
+        $this->assertSame('completed', $generation->status);
+        $this->assertEquals(0.01, $generation->cost_usd);
+        $this->assertNotNull($generation->cost_eur);
+        $this->assertFalse($generation->cost_is_estimated);
+        Storage::disk('public')->assertExists($generation->output_path);
+    }
+
+    public function test_failed_api_call_marks_generation_failed_without_cost(): void
+    {
+        Http::fake([
+            'https://api.runware.ai/v1' => Http::response(['errors' => [['message' => 'boom']]], 400),
+        ]);
+
+        RunwareModel::create([
+            'modality' => 'image', 'air_id' => 'a:cheap@1', 'label' => 'Cheap',
+            'unit' => 'per_image', 'price_usd' => 0.01, 'active' => true, 'is_default' => true,
+        ]);
+
+        $this->expectException(\RuntimeException::class);
+
+        try {
+            $this->service()->createImage('a cat wearing a hat');
+        } finally {
+            $generation = Generation::first();
+            $this->assertSame('failed', $generation->status);
+            $this->assertNull($generation->cost_usd);
+        }
+    }
+
+    public function test_budget_cap_blocks_generation_that_would_exceed_it(): void
+    {
+        config(['runware.monthly_cap_eur' => 0.001]);
+
+        RunwareModel::create([
+            'modality' => 'image', 'air_id' => 'a:pricey@1', 'label' => 'Pricey',
+            'unit' => 'per_image', 'price_usd' => 10, 'active' => true, 'is_default' => true,
+        ]);
+
+        $this->expectException(BudgetExceededException::class);
+
+        $this->service()->createImage('this should never call the API');
+
+        Http::assertNothingSent();
+    }
+
+    public function test_text_generation_falls_back_to_estimated_cost_when_usage_cost_missing(): void
+    {
+        Http::fake([
+            'https://api.runware.ai/v1/chat/completions' => Http::response([
+                'choices' => [['message' => ['content' => 'Hello there']]],
+                'usage' => ['total_tokens' => 100],
+            ]),
+        ]);
+
+        RunwareModel::create([
+            'modality' => 'text', 'air_id' => 't:cheap@1', 'label' => 'Cheap',
+            'unit' => 'per_million_tokens', 'price_usd' => 1, 'active' => true, 'is_default' => true,
+        ]);
+
+        $generation = $this->service()->createText('say hello');
+
+        $this->assertSame('completed', $generation->status);
+        $this->assertSame('Hello there', $generation->output_text);
+        $this->assertTrue($generation->cost_is_estimated);
+        $this->assertEqualsWithDelta(0.0001, $generation->cost_usd, 0.00001);
+    }
+}

tests/Feature/RunwareModelDefaultTest.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\RunwareModel;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class RunwareModelDefaultTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_cheapest_active_model_is_marked_default(): void
+    {
+        $expensive = RunwareModel::create([
+            'modality' => 'image', 'air_id' => 'a:expensive@1', 'label' => 'Expensive',
+            'unit' => 'per_image', 'price_usd' => 0.05, 'active' => true,
+        ]);
+
+        RunwareModel::recomputeDefault('image');
+        $this->assertTrue($expensive->fresh()->is_default);
+
+        $cheap = RunwareModel::create([
+            'modality' => 'image', 'air_id' => 'a:cheap@1', 'label' => 'Cheap',
+            'unit' => 'per_image', 'price_usd' => 0.01, 'active' => true,
+        ]);
+        RunwareModel::recomputeDefault('image');
+
+        $this->assertFalse($expensive->fresh()->is_default);
+        $this->assertTrue($cheap->fresh()->is_default);
+        $this->assertSame($cheap->air_id, RunwareModel::defaultFor('image')->air_id);
+    }
+
+    public function test_inactive_models_are_never_default(): void
+    {
+        $inactiveCheap = RunwareModel::create([
+            'modality' => 'video', 'air_id' => 'v:cheap@1', 'label' => 'Cheap but off',
+            'unit' => 'per_second', 'price_usd' => 0.001, 'active' => false,
+        ]);
+        $active = RunwareModel::create([
+            'modality' => 'video', 'air_id' => 'v:active@1', 'label' => 'Active',
+            'unit' => 'per_second', 'price_usd' => 0.05, 'active' => true,
+        ]);
+
+        RunwareModel::recomputeDefault('video');
+
+        $this->assertFalse($inactiveCheap->fresh()->is_default);
+        $this->assertTrue($active->fresh()->is_default);
+    }
+}

tests/TestCase.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Tests;
+
+use Illuminate\Foundation\Testing\TestCase as BaseTestCase;
+
+abstract class TestCase extends BaseTestCase
+{
+    //
+}

tests/Unit/ExampleTest.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Tests\Unit;
+
+use PHPUnit\Framework\TestCase;
+
+class ExampleTest extends TestCase
+{
+    /**
+     * A basic test example.
+     */
+    public function test_that_true_is_true(): void
+    {
+        $this->assertTrue(true);
+    }
+}

vite.config.js

@@ -0,0 +1,24 @@
+import { defineConfig } from 'vite';
+import laravel from 'laravel-vite-plugin';
+import { bunny } from 'laravel-vite-plugin/fonts';
+import tailwindcss from '@tailwindcss/vite';
+
+export default defineConfig({
+    plugins: [
+        laravel({
+            input: ['resources/css/app.css', 'resources/js/app.js'],
+            refresh: true,
+            fonts: [
+                bunny('Instrument Sans', {
+                    weights: [400, 500, 600],
+                }),
+            ],
+        }),
+        tailwindcss(),
+    ],
+    server: {
+        watch: {
+            ignored: ['**/storage/framework/views/**'],
+        },
+    },
+});