Init project

Author: butschster

.gitignore

@@ -0,0 +1,3 @@
+composer.lock
+/vendor
+/.idea

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) llm-agents-php <[email protected]>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1 @@
+# J

composer.json

@@ -0,0 +1,29 @@
+{
+  "name": "llm-agents/json-schema-mapper",
+  "description": "JSON Schema to PHP Class Mapper for LLM Agents",
+  "license": "MIT",
+  "require": {
+    "php": "^8.3",
+    "spiral/json-schema-generator": "^1.0",
+    "llm-agents/agents": "^1.0",
+    "spiral/boot": "^3.13"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^11.3"
+  },
+  "autoload": {
+    "psr-4": {
+      "LLM\\Agents\\JsonSchema\\Mapper\\": "src"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "LLM\\Tests\\": "tests/src"
+    }
+  },
+  "config": {
+    "sort-packages": true
+  },
+  "minimum-stability": "dev",
+  "prefer-stable": true
+}

src/Bootloader/SchemaMapperBootloader.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LLM\Agents\JsonSchema\Mapper\Bootloader;
+
+use CuyZ\Valinor\Cache\FileSystemCache;
+use CuyZ\Valinor\Mapper\TreeMapper;
+use LLM\Agents\JsonSchema\Mapper\MapperBuilder;
+use LLM\Agents\JsonSchema\Mapper\SchemaMapper;
+use LLM\Agents\Tool\SchemaMapperInterface;
+use Spiral\Boot\Bootloader\Bootloader;
+use Spiral\Boot\DirectoriesInterface;
+use Spiral\Boot\Environment\AppEnvironment;
+
+final class SchemaMapperBootloader extends Bootloader
+{
+    public function defineSingletons(): array
+    {
+        return [
+            SchemaMapperInterface::class => SchemaMapper::class,
+
+            TreeMapper::class => static fn(
+                MapperBuilder $builder,
+            ) => $builder->build(),
+            MapperBuilder::class => static fn(
+                DirectoriesInterface $dirs,
+                AppEnvironment $env,
+            ) => new MapperBuilder(
+                cache: match ($env) {
+                    AppEnvironment::Production => new FileSystemCache(
+                        cacheDir: $dirs->get('runtime') . 'cache/valinor',
+                    ),
+                    default => null,
+                },
+            ),
+        ];
+    }
+}

src/MapperBuilder.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LLM\Agents\JsonSchema\Mapper;
+
+use CuyZ\Valinor\Mapper\TreeMapper;
+use CuyZ\Valinor\MapperBuilder as BaseMapperBuilder;
+use Psr\SimpleCache\CacheInterface;
+
+final readonly class MapperBuilder
+{
+    public function __construct(
+        private ?CacheInterface $cache = null,
+    ) {}
+
+    public function build(): TreeMapper
+    {
+        $builder = (new BaseMapperBuilder())
+            ->enableFlexibleCasting()
+            ->allowPermissiveTypes();
+
+        if ($this->cache) {
+            $builder = $builder->withCache($this->cache);
+        }
+
+        return $builder->mapper();
+    }
+}

src/SchemaMapper.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LLM\Agents\JsonSchema\Mapper;
+
+use CuyZ\Valinor\Mapper\TreeMapper;
+use LLM\Agents\Tool\SchemaMapperInterface;
+use Spiral\JsonSchemaGenerator\Generator as JsonSchemaGenerator;
+
+final readonly class SchemaMapper implements SchemaMapperInterface
+{
+    public function __construct(
+        private JsonSchemaGenerator $generator,
+        private TreeMapper $mapper,
+    ) {}
+
+    public function toJsonSchema(string $class): array
+    {
+        if (\json_validate($class)) {
+            return \json_decode($class, associative: true);
+        }
+
+        if (\class_exists($class)) {
+            return $this->generator->generate($class)->jsonSerialize();
+        }
+
+        throw new \InvalidArgumentException(\sprintf('Invalid class or JSON schema provided: %s', $class));
+    }
+
+    /**
+     * @template T of object
+     * @param class-string<T>|string $class
+     * @return T
+     */
+    public function toObject(string $json, ?string $class = null): object
+    {
+        if ($class === null) {
+            return \json_decode($json, associative: false);
+        }
+
+        return $this->mapper->map($class, \json_decode($json, associative: true));
+    }
+}