feature(providers): Added Vertex support

config/prism.php

@@ -65,6 +65,12 @@
             'api_key' => env('PERPLEXITY_API_KEY', ''),
             'url' => env('PERPLEXITY_URL', 'https://api.perplexity.ai'),
         ],
+        'vertex' => [
+            'project_id' => env('VERTEX_PROJECT_ID', ''),
+            'region' => env('VERTEX_REGION', 'us-central1'),
+            'access_token' => env('VERTEX_ACCESS_TOKEN', null),
+            'credentials_path' => env('VERTEX_CREDENTIALS_PATH', null),
+        ],
         'z' => [
             'url' => env('Z_URL', 'https://api.z.ai/api/paas/v4'),
             'api_key' => env('Z_API_KEY', ''),

docs/providers/vertex.md

@@ -0,0 +1,266 @@
+# Vertex AI
+
+Google Vertex AI provides enterprise-grade access to Google's Gemini models with enhanced security, compliance, and integration with Google Cloud services.
+
+## Configuration
+
+```php
+'vertex' => [
+    'project_id' => env('VERTEX_PROJECT_ID', ''),
+    'region' => env('VERTEX_REGION', 'us-central1'),
+    'access_token' => env('VERTEX_ACCESS_TOKEN', null),
+    'credentials_path' => env('VERTEX_CREDENTIALS_PATH', null),
+],
+```
+
+### Authentication
+
+Vertex AI supports multiple authentication methods:
+
+#### 1. Access Token (Recommended for development)
+
+Provide an access token directly:
+
+```env
+VERTEX_ACCESS_TOKEN=your-access-token
+```
+
+You can obtain an access token using the Google Cloud CLI:
+
+```bash
+gcloud auth print-access-token
+```
+
+#### 2. Service Account Credentials (Recommended for production)
+
+Provide the path to your service account JSON key file:
+
+```env
+VERTEX_CREDENTIALS_PATH=/path/to/service-account.json
+```
+
+#### 3. Application Default Credentials
+
+If no credentials are provided, Prism will attempt to use Application Default Credentials (ADC). Set up ADC by running:
+
+```bash
+gcloud auth application-default login
+```
+
+Or by setting the `GOOGLE_APPLICATION_CREDENTIALS` environment variable:
+
+```bash
+export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
+```
+
+## Basic Usage
+
+### Text Generation
+
+```php
+use Prism\Prism\Facades\Prism;
+use Prism\Prism\Enums\Provider;
+
+$response = Prism::text()
+    ->using(Provider::Vertex, 'gemini-1.5-flash')
+    ->withPrompt('Explain quantum computing in simple terms.')
+    ->asText();
+
+echo $response->text;
+```
+
+### With System Prompt
+
+```php
+$response = Prism::text()
+    ->using(Provider::Vertex, 'gemini-1.5-flash')
+    ->withSystemPrompt('You are a helpful coding assistant.')
+    ->withPrompt('Write a Python function to calculate fibonacci numbers.')
+    ->asText();
+```
+
+## Structured Output
+
+Vertex AI supports structured output, allowing you to define schemas that constrain the model's responses to match your exact data structure requirements.
+
+```php
+use Prism\Prism\Facades\Prism;
+use Prism\Prism\Enums\Provider;
+use Prism\Prism\Schema\ObjectSchema;
+use Prism\Prism\Schema\StringSchema;
+use Prism\Prism\Schema\NumberSchema;
+
+$schema = new ObjectSchema(
+    name: 'user_profile',
+    description: 'A user profile object',
+    properties: [
+        new StringSchema('name', 'The user\'s full name'),
+        new NumberSchema('age', 'The user\'s age'),
+        new StringSchema('email', 'The user\'s email address'),
+    ],
+    requiredFields: ['name', 'age', 'email']
+);
+
+$response = Prism::structured()
+    ->using(Provider::Vertex, 'gemini-1.5-flash')
+    ->withSchema($schema)
+    ->withPrompt('Generate a profile for a fictional user named John Doe.')
+    ->generate();
+
+// Access structured data
+$profile = $response->structured;
+echo $profile['name'];  // "John Doe"
+echo $profile['age'];   // 30
+echo $profile['email']; // "john.doe@example.com"
+```
+
+## Tool Usage
+
+Vertex AI supports function calling (tools) to extend the model's capabilities:
+
+```php
+use Prism\Prism\Facades\Prism;
+use Prism\Prism\Enums\Provider;
+use Prism\Prism\Tool;
+
+$weatherTool = (new Tool)
+    ->as('get_weather')
+    ->for('Get the current weather for a location')
+    ->withStringParameter('location', 'The city and state, e.g. San Francisco, CA')
+    ->using(function (string $location): string {
+        // Your weather API call here
+        return "The weather in {$location} is 72°F and sunny.";
+    });
+
+$response = Prism::text()
+    ->using(Provider::Vertex, 'gemini-1.5-flash')
+    ->withTools([$weatherTool])
+    ->withMaxSteps(3)
+    ->withPrompt('What is the weather like in San Francisco?')
+    ->asText();
+
+echo $response->text;
+```
+
+## Embeddings
+
+Vertex AI supports text embeddings for semantic search, clustering, and other ML tasks:
+
+```php
+use Prism\Prism\Facades\Prism;
+use Prism\Prism\Enums\Provider;
+
+$response = Prism::embeddings()
+    ->using(Provider::Vertex, 'text-embedding-004')
+    ->fromInput('The quick brown fox jumps over the lazy dog.')
+    ->generate();
+
+// Access the embedding vector
+$embedding = $response->embeddings[0]->embedding;
+```
+
+## Streaming
+
+Vertex AI supports streaming responses for real-time output:
+
+```php
+use Prism\Prism\Facades\Prism;
+use Prism\Prism\Enums\Provider;
+
+$stream = Prism::text()
+    ->using(Provider::Vertex, 'gemini-1.5-flash')
+    ->withPrompt('Write a short story about a robot.')
+    ->asStream();
+
+foreach ($stream as $event) {
+    if ($event instanceof \Prism\Prism\Streaming\Events\TextDeltaEvent) {
+        echo $event->delta;
+    }
+}
+```
+
+## Image Understanding
+
+Vertex AI supports multimodal inputs including images:
+
+```php
+use Prism\Prism\Facades\Prism;
+use Prism\Prism\Enums\Provider;
+use Prism\Prism\ValueObjects\Messages\UserMessage;
+use Prism\Prism\ValueObjects\Media\Image;
+
+$response = Prism::text()
+    ->using(Provider::Vertex, 'gemini-1.5-flash')
+    ->withMessages([
+        new UserMessage(
+            'What do you see in this image?',
+            additionalContent: [
+                Image::fromLocalPath('/path/to/image.png'),
+            ],
+        ),
+    ])
+    ->asText();
+
+echo $response->text;
+```
+
+## Thinking Mode
+
+For models that support it (like Gemini 2.5), you can configure thinking mode:
+
+```php
+$response = Prism::text()
+    ->using(Provider::Vertex, 'gemini-2.5-flash-preview')
+    ->withPrompt('Solve this complex math problem...')
+    ->withProviderOptions([
+        'thinkingBudget' => 2048,
+    ])
+    ->asText();
+
+// Access thinking token usage
+echo $response->usage->thoughtTokens;
+```
+
+## Available Models
+
+Vertex AI provides access to Google's Gemini model family:
+
+| Model | Description |
+|-------|-------------|
+| `gemini-1.5-flash` | Fast and efficient for most tasks |
+| `gemini-1.5-pro` | Most capable model for complex tasks |
+| `gemini-2.0-flash` | Latest generation with improved capabilities |
+| `gemini-2.5-flash-preview` | Preview of next generation with thinking support |
+| `text-embedding-004` | Text embeddings model |
+
+## Regions
+
+Vertex AI is available in multiple regions. Common options include:
+
+- `us-central1` (default)
+- `us-east1`
+- `us-west1`
+- `europe-west1`
+- `europe-west4`
+- `asia-northeast1`
+- `asia-southeast1`
+
+Configure your region in the `.env` file:
+
+```env
+VERTEX_REGION=us-central1
+```
+
+## Differences from Gemini API
+
+While Vertex AI uses the same underlying Gemini models, there are key differences:
+
+| Feature | Gemini API | Vertex AI |
+|---------|------------|-----------|
+| Authentication | API Key | OAuth 2.0 / Service Account |
+| Pricing | Pay-as-you-go | Google Cloud billing |
+| Data residency | Global | Regional control |
+| Enterprise features | Limited | Full (VPC, audit logs, etc.) |
+| SLA | None | Enterprise SLA available |
+
+Choose Vertex AI when you need enterprise-grade security, compliance, or integration with other Google Cloud services.

src/Enums/Provider.php

@@ -18,5 +18,6 @@ enum Provider: string
     case VoyageAI = 'voyageai';
     case ElevenLabs = 'elevenlabs';
     case Perplexity = 'perplexity';
+    case Vertex = 'vertex';
     case Z = 'z';
 }

src/PrismManager.php

@@ -19,6 +19,7 @@
 use Prism\Prism\Providers\OpenRouter\OpenRouter;
 use Prism\Prism\Providers\Perplexity\Perplexity;
 use Prism\Prism\Providers\Provider;
+use Prism\Prism\Providers\Vertex\Vertex;
 use Prism\Prism\Providers\VoyageAI\VoyageAI;
 use Prism\Prism\Providers\XAI\XAI;
 use Prism\Prism\Providers\Z\Z;
@@ -226,6 +227,19 @@ protected function createElevenlabsProvider(array $config): ElevenLabs
         );
     }
 
+    /**
+     * @param  array<string, string>  $config
+     */
+    protected function createVertexProvider(array $config): Vertex
+    {
+        return new Vertex(
+            projectId: $config['project_id'] ?? '',
+            region: $config['region'] ?? 'us-central1',
+            accessToken: $config['access_token'] ?? null,
+            credentialsPath: $config['credentials_path'] ?? null,
+        );
+    }
+
     /**
      * @param  array<string, string>  $config
      */

src/Providers/Vertex/Concerns/ValidatesResponse.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Prism\Prism\Providers\Vertex\Concerns;
+
+use Illuminate\Http\Client\Response;
+use Prism\Prism\Exceptions\PrismException;
+
+trait ValidatesResponse
+{
+    protected function validateResponse(Response $response): void
+    {
+        $data = $response->json();
+
+        if (! $data || data_get($data, 'error')) {
+            throw PrismException::providerResponseError(vsprintf(
+                'Vertex Error: [%s] %s',
+                [
+                    data_get($data, 'error.code', 'unknown'),
+                    data_get($data, 'error.message', 'unknown'),
+                ]
+            ));
+        }
+    }
+}