bug #1199 [AI Bundle][Profiler] avoid serializing closures for files and images (uerka)

This PR was squashed before being merged into the main branch.

Discussion
----------

[AI Bundle][Profiler] avoid serializing closures for files and images

| Q             | A
| ------------- | ---
| Bug fix?      | yes
| New feature?  | no
| Docs?         | no
| Issues        |
| License       | MIT

Currently when agent call includes images/files profiler throws exception 'Serialization of 'Closure' is not allowed' and therefore cannot store profile.
Added __serialize() methods to File class and also displaying of files/images in profiler.

Commits
-------

90ced03 [AI Bundle][Profiler] avoid serializing closures for files and images

Author: OskarStark

src/ai-bundle/templates/data_collector.html.twig

@@ -119,8 +119,10 @@
                                                             {% for item in message.content %}
                                                                 {% if item.text is defined %}
                                                                     {{ item.text|nl2br }}
-                                                                {% else %}
-                                                                    <img src="{{ item.url }}" />
+                                                                {% elseif item.format is defined and item.format starts with 'image/'  %}
+                                                                    <img src="{{ item.asDataUrl }}" style="max-width: 100%;"/>
+                                                                {% elseif item.asDataUrl  %}
+                                                                    <a href="{{ item.asDataUrl }}" download="{{ item.filename ?? 'View File' }}">{{ item.filename ?? 'View File' }}</a>
                                                                 {% endif %}
                                                             {% endfor %}
                                                         {% else %}

src/platform/src/Message/Content/File.php

@@ -28,6 +28,18 @@ final public function __construct(
     ) {
     }
 
+    /**
+     * @return array{data: string, path: string|null, format: string}
+     */
+    public function __serialize(): array
+    {
+        return [
+            'data' => $this->data instanceof \Closure ? ($this->data)() : $this->data,
+            'format' => $this->format,
+            'path' => $this->path,
+        ];
+    }
+
     public static function fromDataUrl(string $dataUrl): static
     {
         if (!str_starts_with($dataUrl, 'data:')) {

src/platform/tests/Message/Content/AudioTest.php

@@ -56,4 +56,14 @@ public function testFromFileWithInvalidPath()
 
         Audio::fromFile('foo.mp3');
     }
+
+    public function testCanBeSerialized()
+    {
+        $audio = Audio::fromFile(\dirname(__DIR__, 5).'/fixtures/audio.mp3');
+
+        $serialized = serialize($audio);
+        $unserialized = unserialize($serialized);
+        $this->assertInstanceOf(Audio::class, $unserialized);
+        $this->assertSame('audio.mp3', $unserialized->getFilename());
+    }
 }

src/platform/tests/Message/Content/FileTest.php

@@ -0,0 +1,49 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\AI\Platform\Tests\Message\Content;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\AI\Platform\Message\Content\File;
+
+final class FileTest extends TestCase
+{
+    public function testConstructWithValidDataUrl()
+    {
+        $image = File::fromDataUrl('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABKklEQVR42mNk+A8AAwMhIv9n+X');
+
+        $this->assertStringStartsWith('data:image/png;base64', $image->asDataUrl());
+    }
+
+    public function testWithValidFile()
+    {
+        $image = File::fromFile(\dirname(__DIR__, 5).'/fixtures/image.jpg');
+
+        $this->assertStringStartsWith('data:image/jpeg;base64,', $image->asDataUrl());
+    }
+
+    public function testFromBinaryWithInvalidFile()
+    {
+        $this->expectExceptionMessage('The file "foo.jpg" does not exist or is not readable.');
+
+        File::fromFile('foo.jpg');
+    }
+
+    public function testCanBeSerialized()
+    {
+        $audio = File::fromFile(\dirname(__DIR__, 5).'/fixtures/image.jpg');
+
+        $serialized = serialize($audio);
+        $unserialized = unserialize($serialized);
+        $this->assertInstanceOf(File::class, $unserialized);
+        $this->assertSame('image.jpg', $unserialized->getFilename());
+    }
+}

src/platform/tests/Message/Content/ImageTest.php

@@ -36,4 +36,14 @@ public function testFromBinaryWithInvalidFile()
 
         Image::fromFile('foo.jpg');
     }
+
+    public function testCanBeSerialized()
+    {
+        $audio = Image::fromFile(\dirname(__DIR__, 5).'/fixtures/image.jpg');
+
+        $serialized = serialize($audio);
+        $unserialized = unserialize($serialized);
+        $this->assertInstanceOf(Image::class, $unserialized);
+        $this->assertSame('image.jpg', $unserialized->getFilename());
+    }
 }