chore: add GrokAI Service

Author: thefeqy

src/Facades/GrokAI.php

@@ -2,15 +2,17 @@
 
 namespace GrokPHP\Laravel\Facades;
 
+use GrokPHP\Client\Clients\Vision;
 use Illuminate\Support\Facades\Facade;
 
 /**
- * @method static array chat(array $messages, \GrokPHP\Client\Config\ChatOptions $options)
+ * @method static array chat(array $messages, ?\GrokPHP\Client\Config\ChatOptions $options = null)
+ * @method static Vision vision()
  */
 class GrokAI extends Facade
 {
     protected static function getFacadeAccessor(): string
     {
-        return 'grok-ai';
+        return \GrokPHP\Laravel\Services\GrokAI::class;
     }
 }

src/Providers/GrokServiceProvider.php

@@ -3,6 +3,7 @@
 namespace GrokPHP\Laravel\Providers;
 
 use GrokPHP\Laravel\Commands\InstallGrokCommand;
+use GrokPHP\Laravel\Services\GrokAI;
 use Illuminate\Support\ServiceProvider;
 use GrokPHP\Client\Clients\GrokClient;
 use GrokPHP\Client\Config\GrokConfig;
@@ -26,6 +27,10 @@ public function register(): void
             return new GrokClient($app->make(GrokConfig::class));
         });
 
+        $this->app->singleton(GrokAI::class, function ($app) {
+            return new GrokAI($app->make(GrokClient::class));
+        });
+
         $this->app->alias(GrokClient::class, 'grok-ai');
     }
 

src/Services/GrokAI.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace GrokPHP\Laravel\Services;
+
+use GrokPHP\Client\Clients\GrokClient;
+use GrokPHP\Client\Config\ChatOptions;
+use GrokPHP\Client\Enums\Model;
+use GrokPHP\Client\Exceptions\GrokException;
+use GrokPHP\Laravel\Support\GrokResponse;
+
+class GrokAI
+{
+    protected GrokClient $client;
+
+    public function __construct(GrokClient $client)
+    {
+        $this->client = $client;
+    }
+
+    /**
+     * Send a chat completion request to Grok API.
+     * @param array $messages
+     * @param ChatOptions|null $options
+     * @return GrokResponse
+     * @throws GrokException
+     */
+    public function chat(array $messages, ?ChatOptions $options = null): GrokResponse
+    {
+        $options = $options ?? new ChatOptions(
+            model: Model::GROK_2,
+            temperature: 0.7,
+            stream: false
+        );
+
+        $response = $this->client->chat($messages, $options);
+
+        return new GrokResponse($response);
+    }
+
+    /**
+     * Analyze an image using Grok Vision models.
+     * @return GrokVision
+     */
+    public function vision(): GrokVision
+    {
+        return new GrokVision($this->client);
+    }
+}