Integrate LLM Chain Bundle as AI Bundle

src/ai-bundle/.gitattributes

@@ -0,0 +1,6 @@
+/.github export-ignore
+/tests export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+phpstan.dist.neon export-ignore
+phpunit.xml.dist export-ignore

src/ai-bundle/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,8 @@
+Please do not submit any Pull Requests here. They will be closed.
+---
+
+Please submit your PR here instead:
+https://github.com/symfony/ai
+
+This repository is what we call a "subtree split": a read-only subset of that main repository.
+We're looking forward to your PR there!

src/ai-bundle/.github/workflows/close-pull-request.yml

@@ -0,0 +1,20 @@
+name: Close Pull Request
+
+on:
+  pull_request_target:
+    types: [opened]
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: superbrothers/close-pull-request@v3
+        with:
+          comment: |
+            Thanks for your Pull Request! We love contributions.
+
+            However, you should instead open your PR on the main repository:
+            https://github.com/symfony/ai
+
+            This repository is what we call a "subtree split": a read-only subset of that main repository.
+            We're looking forward to your PR there!

src/ai-bundle/.gitignore

@@ -0,0 +1,5 @@
+vendor
+composer.lock
+.php-cs-fixer.cache
+.phpunit.cache
+coverage

src/ai-bundle/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2025-present Fabien Potencier
+
+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.

src/ai-bundle/README.md

@@ -0,0 +1,176 @@
+# Symfony AI Bundle
+
+Integration bundle for Symfony AI components.
+
+## Installation
+
+```bash
+composer require symfony/ai-bundle
+```
+
+## Configuration
+
+### Simple Example with OpenAI
+
+```yaml
+# config/packages/ai.yaml
+ai:
+    platform:
+        openai:
+            api_key: '%env(OPENAI_API_KEY)%'
+    agent:
+        default:
+            model:
+                name: 'GPT'
+```
+
+### Advanced Example with Anthropic, Azure, Google and multiple agents
+```yaml
+# config/packages/ai.yaml
+ai:
+    platform:
+        anthropic:
+            api_key: '%env(ANTHROPIC_API_KEY)%'
+        azure:
+            # multiple deployments possible
+            gpt_deployment:
+                base_url: '%env(AZURE_OPENAI_BASEURL)%'
+                deployment: '%env(AZURE_OPENAI_GPT)%'
+                api_key: '%env(AZURE_OPENAI_KEY)%'
+                api_version: '%env(AZURE_GPT_VERSION)%'
+        google:
+            api_key: '%env(GOOGLE_API_KEY)%'
+    agent:
+        rag:
+            platform: 'symfony_ai.platform.azure.gpt_deployment'
+            structured_output: false # Disables support for "output_structure" option, default is true
+            model:
+                name: 'GPT'
+                version: 'gpt-4o-mini'
+            system_prompt: 'You are a helpful assistant that can answer questions.' # The default system prompt of the agent
+            include_tools: true # Include tool definitions at the end of the system prompt
+            tools:
+                # Referencing a service with #[AsTool] attribute
+                - 'Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch'
+
+                # Referencing a service without #[AsTool] attribute
+                - service: 'App\Agent\Tool\CompanyName'
+                  name: 'company_name'
+                  description: 'Provides the name of your company'
+                  method: 'foo' # Optional with default value '__invoke'
+
+                # Referencing a agent => agent in agent 🤯
+                - service: 'symfony_ai.agent.research'
+                  name: 'wikipedia_research'
+                  description: 'Can research on Wikipedia'
+                  is_agent: true
+        research:
+            platform: 'symfony_ai.platform.anthropic'
+            model:
+                name: 'Claude'
+            tools: # If undefined, all tools are injected into the agent, use "tools: false" to disable tools.
+                - 'Symfony\AI\Agent\Toolbox\Tool\Wikipedia'
+            fault_tolerant_toolbox: false # Disables fault tolerant toolbox, default is true
+    store:
+        # also azure_search, mongodb and pinecone are supported as store type
+        chroma_db:
+            # multiple collections possible per type
+            default:
+                collection: 'my_collection'
+    embedder:
+        default:
+            # platform: 'symfony_ai.platform.anthropic'
+            # store: 'symfony_ai.store.chroma_db.default'
+            model:
+                name: 'Embeddings'
+                version: 'text-embedding-ada-002'
+```
+
+## Usage
+
+### Agent Service
+
+Use the `Agent` service to leverage models and tools:
+```php
+use Symfony\AI\Agent\AgentInterface;
+use Symfony\AI\Platform\Message\Message;
+use Symfony\AI\Platform\Message\MessageBag;
+
+final readonly class MyService
+{
+    public function __construct(
+        private AgentInterface $agent,
+    ) {
+    }
+
+    public function submit(string $message): string
+    {
+        $messages = new MessageBag(
+            Message::forSystem('Speak like a pirate.'),
+            Message::ofUser($message),
+        );
+
+        return $this->agent->call($messages);
+    }
+}
+```
+
+### Register Tools
+
+To use existing tools, you can register them as a service:
+```yaml
+services:
+    _defaults:
+        autowire: true
+        autoconfigure: true
+
+    Symfony\AI\Agent\Toolbox\Tool\Clock: ~
+    Symfony\AI\Agent\Toolbox\Tool\OpenMeteo: ~
+    Symfony\AI\Agent\Toolbox\Tool\SerpApi:
+        $apiKey: '%env(SERP_API_KEY)%'
+    Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch: ~
+    Symfony\AI\Agent\Toolbox\Tool\Tavily:
+      $apiKey: '%env(TAVILY_API_KEY)%'
+    Symfony\AI\Agent\Toolbox\Tool\Wikipedia: ~
+    Symfony\AI\Agent\Toolbox\Tool\YouTubeTranscriber: ~
+```
+
+Custom tools can be registered by using the `#[AsTool]` attribute:
+
+```php
+use Symfony\AI\Agent\Toolbox\Attribute\AsTool;
+
+#[AsTool('company_name', 'Provides the name of your company')]
+final class CompanyName
+{
+    public function __invoke(): string
+    {
+        return 'ACME Corp.'
+    }
+}
+```
+
+The agent configuration by default will inject all known tools into the agent.
+
+To disable this behavior, set the `tools` option to `false`:
+```yaml
+ai:
+    agent:
+        my_agent:
+            tools: false
+```
+
+To inject only specific tools, list them in the configuration:
+```yaml
+ai:
+    agent:
+        my_agent:
+            tools:
+                - 'Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch'
+```
+
+### Profiler
+
+The profiler panel provides insights into the agent's execution:
+
+![Profiler](./profiler.png)

src/ai-bundle/composer.json

@@ -0,0 +1,48 @@
+{
+    "name": "symfony/ai-bundle",
+    "type": "symfony-bundle",
+    "description": "Integration bundle for Symfony AI components",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Christopher Hertel",
+            "email": "[email protected]"
+        },
+        {
+            "name": "Oskar Stark",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {
+        "php": ">=8.2",
+        "symfony/ai-agent": "@dev",
+        "symfony/ai-platform": "@dev",
+        "symfony/ai-store": "@dev",
+        "symfony/config": "^6.4 || ^7.0",
+        "symfony/dependency-injection": "^6.4 || ^7.0",
+        "symfony/framework-bundle": "^6.4 || ^7.0",
+        "symfony/string": "^6.4 || ^7.0"
+    },
+    "require-dev": {
+        "phpstan/phpstan": "^2.1",
+        "phpunit/phpunit": "^11.5"
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "autoload": {
+        "psr-4": {
+            "Symfony\\AI\\AIBundle\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Symfony\\AI\\AIBundle\\Tests\\": "tests/"
+        }
+    },
+    "repositories": [
+        {"type": "path", "url": "../agent"},
+        {"type": "path", "url": "../platform"},
+        {"type": "path", "url": "../store"}
+    ]
+}

src/ai-bundle/phpstan.dist.neon

@@ -0,0 +1,7 @@
+parameters:
+    level: 6
+    paths:
+        - src/
+    excludePaths:
+        analyse:
+            - src/DependencyInjection/Configuration.php

src/ai-bundle/phpunit.xml.dist

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.3/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         cacheDirectory=".phpunit.cache"
+         colors="true"
+         executionOrder="depends,defects"
+         requireCoverageMetadata="true"
+         beStrictAboutCoverageMetadata="true"
+         beStrictAboutOutputDuringTests="true"
+         failOnRisky="true"
+         failOnWarning="true">
+    <testsuites>
+        <testsuite name="default">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+
+    <source ignoreIndirectDeprecations="true" restrictNotices="true" restrictWarnings="true">
+        <include>
+            <directory>src</directory>
+        </include>
+    </source>
+</phpunit>

src/ai-bundle/src/AIBundle.php

@@ -0,0 +1,21 @@
+<?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\AIBundle;
+
+use Symfony\Component\HttpKernel\Bundle\Bundle;
+
+/**
+ * @author Christopher Hertel <[email protected]>
+ */
+final class AIBundle extends Bundle
+{
+}