Read description for schema to give more context to the LLM

src/StructuredOutput/SchemaFactory.php

@@ -52,6 +52,7 @@ public function buildSchema(string $className): array
         foreach ($properties as $property) {
             $propertyName = $property->getName();
             $types = $this->propertyInfo->getTypes($className, $propertyName);
+            $description = $this->propertyInfo->getShortDescription($className, $propertyName);
 
             if (empty($types)) {
                 // Skip if no type info is available
@@ -62,6 +63,11 @@ public function buildSchema(string $className): array
             $type = $types[0];
             $propertySchema = $this->getTypeSchema($type);
 
+            // Add description if available
+            if ($description) {
+                $propertySchema['description'] = $description;
+            }
+
             // Add property schema to main schema
             $schema['properties'][$propertyName] = $propertySchema;
 

tests/StructuredOutput/Data/User.php

@@ -7,6 +7,9 @@
 final class User
 {
     public int $id;
+    /**
+     * @var string The name of the user in lowercase
+     */
     public string $name;
     public \DateTimeInterface $createdAt;
     public bool $isActive;

tests/StructuredOutput/SchemaFactoryTest.php

@@ -30,7 +30,10 @@ public function buildSchemaForUserClass(): void
             'type' => 'object',
             'properties' => [
                 'id' => ['type' => 'integer'],
-                'name' => ['type' => 'string'],
+                'name' => [
+                    'type' => 'string',
+                    'description' => 'The name of the user in lowercase',
+                ],
                 'createdAt' => [
                     'type' => 'string',
                     'format' => 'date-time',