Create symfony/ai-tools package

Move third-party tools from agent component to new dedicated package:
- Brave Search, Firecrawl, Mapbox, OpenMeteo, SerpApi, Tavily, Wikipedia, YouTube Transcriber
- Create new package structure with composer.json, tests, documentation
- Update namespaces from Symfony\AI\Agent\Toolbox\Tool to Symfony\AI\Toolbox\Tool
- Reorganize test fixtures into tool-specific subdirectories
- Update examples and demo configurations to use new package
- Clean up agent component by removing moved tools and fixtures

Author: OskarStark

README.md

@@ -17,6 +17,7 @@ Symfony AI consists of several lower and higher level **components** and the res
   * **[Agent](src/agent/README.md)**: Framework for building AI agents that can interact with users and perform tasks.
   * **[Store](src/store/README.md)**: Data storage abstraction with indexing and retrieval for AI applications.
   * **[MCP SDK](src/mcp-sdk/README.md)**: SDK for [Model Context Protocol](https://modelcontextprotocol.io) enabling communication between AI agents and tools.
+  * **[Toolbox](src/tools/README.md)**: Collection of third-party tools for AI agents.
 * **Bundles**
   * **[AI Bundle](src/ai-bundle/README.md)**: Symfony integration for AI Platform, Store and Agent components.
   * **[MCP Bundle](src/mcp-bundle/README.md)**: Symfony integration for MCP SDK, allowing them to act as MCP servers or clients.

demo/composer.json

@@ -13,6 +13,7 @@
         "php-http/discovery": "^1.20",
         "runtime/frankenphp-symfony": "^0.2.0",
         "symfony/ai-bundle": "@dev",
+        "symfony/ai-tools": "@dev",
         "symfony/asset": "~7.3.0",
         "symfony/asset-mapper": "~7.3.0",
         "symfony/clock": "~7.3.0",

demo/config/packages/ai.yaml

@@ -38,7 +38,7 @@ ai:
                 text: 'Please answer the users question based on Wikipedia and provide a link to the article.'
                 include_tools: true
             tools:
-                - 'Symfony\AI\Agent\Toolbox\Tool\Wikipedia'
+                - 'Symfony\AI\Toolbox\Tool\Wikipedia'
         audio:
             model:
                 class: 'Symfony\AI\Platform\Bridge\OpenAi\Gpt'
@@ -75,14 +75,15 @@ services:
         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\Wikipedia: ~
     Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch:
         $vectorizer: '@ai.vectorizer.openai'
         $store: '@ai.store.chroma_db.symfonycon'
 
+    # Symfony\AI\Toolbox\Tool\OpenMeteo: ~
+    # Symfony\AI\Toolbox\Tool\SerpApi:
+    #     $apiKey: '%env(SERP_API_KEY)%'
+    Symfony\AI\Toolbox\Tool\Wikipedia: ~
+
     Symfony\AI\Store\Document\Loader\RssFeedLoader: ~
     Symfony\AI\Store\Document\Transformer\TextTrimTransformer: ~
 

examples/aimlapi/toolcall.php

@@ -11,13 +11,13 @@
 
 use Symfony\AI\Agent\Agent;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Wikipedia;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\AiMlApi\Completions;
 use Symfony\AI\Platform\Bridge\AiMlApi\PlatformFactory;
 use Symfony\AI\Platform\Capability;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
+use Symfony\AI\Toolbox\Tool\Wikipedia;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 

examples/anthropic/toolcall.php

@@ -11,12 +11,12 @@
 
 use Symfony\AI\Agent\Agent;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Wikipedia;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\Anthropic\Claude;
 use Symfony\AI\Platform\Bridge\Anthropic\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
+use Symfony\AI\Toolbox\Tool\Wikipedia;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 

examples/bedrock/toolcall-claude.php

@@ -11,12 +11,12 @@
 
 use Symfony\AI\Agent\Agent;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Wikipedia;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\Anthropic\Claude;
 use Symfony\AI\Platform\Bridge\Bedrock\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
+use Symfony\AI\Toolbox\Tool\Wikipedia;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 

examples/bedrock/toolcall-nova.php

@@ -11,12 +11,12 @@
 
 use Symfony\AI\Agent\Agent;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Wikipedia;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\Bedrock\Nova\Nova;
 use Symfony\AI\Platform\Bridge\Bedrock\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
+use Symfony\AI\Toolbox\Tool\Wikipedia;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 

examples/composer.json

@@ -19,6 +19,7 @@
         "symfony/ai-agent": "@dev",
         "symfony/ai-platform": "@dev",
         "symfony/ai-store": "@dev",
+        "symfony/ai-tools": "@dev",
         "symfony/cache": "^7.3|^8.0",
         "symfony/console": "^7.3|^8.0",
         "symfony/css-selector": "^7.3|^8.0",

examples/dockermodelrunner/toolcall.php

@@ -11,12 +11,12 @@
 
 use Symfony\AI\Agent\Agent;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Wikipedia;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\DockerModelRunner\Completions;
 use Symfony\AI\Platform\Bridge\DockerModelRunner\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
+use Symfony\AI\Toolbox\Tool\Wikipedia;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 

examples/mistral/toolcall-stream.php

@@ -11,12 +11,12 @@
 
 use Symfony\AI\Agent\Agent;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\YouTubeTranscriber;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\Mistral\Mistral;
 use Symfony\AI\Platform\Bridge\Mistral\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
+use Symfony\AI\Toolbox\Tool\YouTubeTranscriber;
 
 require_once dirname(__DIR__).'/bootstrap.php';