Adds laravel support

Author: butschster

README.md

@@ -51,7 +51,7 @@ If you're using the Spiral framework (and why wouldn't you be? It's awesome!), y
 Here's how:
 
 1. Open up your `app/src/Application/Kernel.php` file.
-2. Add the SchemaMapperBootloader to the `defineBootloaders()` method:
+2. Add the `LLM\Agents\JsonSchema\Mapper\Integration\Spiral\SchemaMapperBootloader` to the `defineBootloaders()` method:
 
 ```php
 class Kernel extends \Spiral\Framework\Kernel
@@ -62,14 +62,23 @@ class Kernel extends \Spiral\Framework\Kernel
     {
         return [
             // ... other bootloaders ...
-            \LLM\Agents\JsonSchema\Mapper\Bootloader\SchemaMapperBootloader::class,
+            \LLM\Agents\JsonSchema\Mapper\Integration\Spiral\SchemaMapperBootloader::class,
         ];
     }
 }
 ```
 
 And that's it! The bootloader will take care of registering the SchemaMapper for you.
 
+### Setting it up in Laravel
+
+If you're using the Spiral framework (and why wouldn't you be? It's awesome!), you'll need to register the bootloader.
+Here's how:
+
+Just register the `LLM\Agents\JsonSchema\Mapper\Integration\Laravel\SchemaMapperServiceProvider`
+
+And that's it! The service provider will take care of registering the SchemaMapper for you.
+
 ## How to Use It
 
 ### Converting a PHP Class to JSON Schema

composer.json

@@ -6,11 +6,12 @@
     "php": "^8.3",
     "spiral/json-schema-generator": "^1.0",
     "llm-agents/agents": "^1.0",
-    "cuyz/valinor": "^1.12",
-    "spiral/boot": "^3.13"
+    "cuyz/valinor": "^1.12"
   },
   "require-dev": {
-    "phpunit/phpunit": "^11.3"
+    "phpunit/phpunit": "^11.3",
+    "spiral/boot": "^3.13",
+    "illuminate/support": "^v11.0"
   },
   "autoload": {
     "psr-4": {

src/Integration/Laravel/SchemaMapperServiceProvider.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LLM\Agents\JsonSchema\Mapper\Integration\Laravel;
+
+use CuyZ\Valinor\Cache\FileSystemCache;
+use CuyZ\Valinor\Mapper\TreeMapper;
+use Illuminate\Contracts\Foundation\Application;
+use Illuminate\Support\ServiceProvider;
+use LLM\Agents\JsonSchema\Mapper\MapperBuilder;
+use LLM\Agents\JsonSchema\Mapper\SchemaMapper;
+use LLM\Agents\Tool\SchemaMapperInterface;
+
+final class SchemaMapperServiceProvider extends ServiceProvider
+{
+    public function register(): void
+    {
+        $this->app->singleton(
+            SchemaMapperInterface::class,
+            SchemaMapper::class,
+        );
+
+        $this->app->singleton(
+            TreeMapper::class,
+            static fn(
+                MapperBuilder $builder,
+            ) => $builder->build(),
+        );
+
+        $this->app->singleton(
+            MapperBuilder::class,
+            static fn(
+                Application $app,
+            ) => new MapperBuilder(
+                cache: match (true) {
+                    $app->environment('prod') => new FileSystemCache(
+                        cacheDir: $app->storagePath('cache/valinor'),
+                    ),
+                    default => null,
+                },
+            ),
+        );
+    }
+}

src/Bootloader/SchemaMapperBootloader.php renamed to src/Integration/Spiral/SchemaMapperBootloader.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace LLM\Agents\JsonSchema\Mapper\Bootloader;
+namespace LLM\Agents\JsonSchema\Mapper\Integration\Spiral;
 
 use CuyZ\Valinor\Cache\FileSystemCache;
 use CuyZ\Valinor\Mapper\TreeMapper;